Scroll
ProductPricingStart for free
EvoraDocs
Get started
C++ SDK
REST API
Manage
Endpoint reference
All endpoints
GETPlan quota and current usage
GETList applicationsPOSTCreate an applicationGETGet an applicationPUTUpdate an applicationDELETEDelete an application
GETApplication statisticsGETExtended overviewGETLogin activity by dayGETUser growth over timeGETLicense status breakdownGETSession trends
GETList licensesPOSTGenerate licensesGETGet a licensePUTUpdate a licenseDELETEDelete a licensePOSTBan a licensePOSTUnban a licensePOSTReset a license HWIDPOSTFreeze a licensePOSTResume a frozen licensePOSTAdjust license expiry by a signed deltaPOSTBulk license actions
GETLook up a customer by usernameGETList customersPOSTCreate a customerGETGet a customerPUTUpdate a customerDELETEDelete a customerPOSTMint a password-reset tokenPOSTConsume a reset token and set the new passwordPOSTBan a customerPOSTUnban a customerPOSTReset a customer's HWIDGETRead a customer's two-factor stateDELETEReset a customer's two-factor authenticationPOSTReset a customer's device bindingPOSTMint a one-time SDK login token (panel SSO)POSTRedeem a license key on a customer's behalfPOSTBulk customer actions
POSTAuthenticate a customer by license keyPOSTAuthenticate a customer by username and password
GETList a customer's subscriptionsPOSTGrant a subscription directlyDELETERemove a subscriptionPOSTFreeze a subscriptionPOSTResume a frozen subscriptionPOSTExtend a subscription by days
GETList tiersPOSTCreate a tierPUTUpdate a tierDELETEDelete a tier
GETList app variablesPOSTCreate or update a variableDELETEDelete all app variablesGETGet a variablePUTUpdate a variableDELETEDelete a variableGETList every user variable in the applicationGETList one customer's variablesPOSTSet a customer variableDELETEDelete all of a customer's variablesDELETEDelete a customer variable
GETList webhooksPOSTCreate a webhookGETGet a webhookPUTUpdate a webhookDELETEDelete a webhookPOSTFire a test deliveryGETRead the event stream (catch-up)
GETList blacklist entriesPOSTAdd a blacklist entryDELETERemove a blacklist entryGETList whitelist entriesPOSTAdd a whitelist entryDELETERemove a whitelist entry
GETList live sessionsDELETEKill a sessionPOSTKill every live session
GETList logsGETLog statistics
GETList sellersPOSTCreate a sellerGETGet a sellerPUTUpdate a sellerDELETEDelete a sellerPOSTAdd seller balance
GETList clientsPOSTCreate a clientPUTUpdate a clientDELETEDelete a clientGETList a client's application accessPOSTGrant application accessDELETERevoke application access
GETList entitlementsPOSTCreate an entitlementPUTUpdate an entitlementDELETEDelete an entitlementGETList entitlements attached to a tierPOSTAttach an entitlement to a tierGETResolve a customer's entitlements
GETList geo rulesPOSTAdd a geo ruleDELETERemove a geo rulePUTEnable or disable geo restrictions
GETList active leasesDELETERevoke a leaseGETSeat usage for a customer
Docs/API reference/Users

Read a customer's two-factor state

GEThttps://api.evora.cx/api/developer-api/users/{userId}/2fa
Requires scopeusers:read

Whether the customer has enrolled a second factor, when they did, how many single-use backup codes they have left, and whether their second factor is currently locked out after repeated wrong codes.

Never returns the shared secret or the backup codes themselves — the codes are stored hashed and the secret is not retrievable after enrolment.

Path parameters
userIdrequired
string (uuid)
End-user UUID.
Responses
200Two-factor state.
json
{
  "enabled": true,
  "enrolled_at": "2026-08-21T14:20:55.243Z",
  "backup_codes_remaining": 8,
  "locked_until": null
}
404User not found, or not yours.
json
{
  "error": "User not found"
}

More in Users

  • GETLook up a customer by username
  • GETList customers
  • POSTCreate a customer
  • GETGet a customer
  • PUTUpdate a customer
  • DELETEDelete a customer
  • POSTMint a password-reset token
  • POSTConsume a reset token and set the new password
  • POSTBan a customer
  • POSTUnban a customer
  • POSTReset a customer's HWID
  • DELETEReset a customer's two-factor authentication
  • POSTReset a customer's device binding
  • POSTMint a one-time SDK login token (panel SSO)
  • POSTRedeem a license key on a customer's behalf
  • POSTBulk customer actions

Base URL https://api.evora.cx/api/developer-api · full spec at developer-api.yaml · back to the docs