Daon · Schema
TOTPValidationResult
A response structure for validating TOTP, returned from complete totp registration and totp authentication calls.
CompanyDigital IdentityIdentity VerificationAuthenticationBiometricsFraud PreventionMulti-Factor AuthenticationFIDO
Properties
| Name | Type | Description |
|---|---|---|
| userTOTP | object | |
| user | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/daon/json-schema/daon-totpvalidation-result-schema.json",
"title": "TOTPValidationResult",
"description": "A response structure for validating TOTP, returned from complete totp registration and totp authentication calls.",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/daon-user-totp-management-api-openapi.yml#/components/schemas/TOTPValidationResult",
"type": "object",
"properties": {
"userTOTP": {
"$ref": "#/$defs/UserTOTP"
},
"user": {
"$ref": "#/$defs/UserDto"
}
},
"$defs": {
"AppkeySummary": {
"type": "object",
"description": "Summary information about an appkey registered to the user.\n\n**NOTE** The device information is only available if the `DEVICE_INFO` extension is enabled in the appkey registration policy.",
"properties": {
"id": {
"type": "string",
"description": "The database identifier of the entity"
},
"createdDtm": {
"type": "string",
"format": "date-time"
},
"lastUpdatedDtm": {
"type": "string",
"format": "date-time"
},
"deviceId": {
"type": "string",
"description": "A unique identifier of the device on which the appkey is installed\n\n**NOTE** This is actually an identifier of the client application in which the appkey has been created. It is only available if the `DEVICE_INFO` extension s enabled in the appkey registration policy."
},
"deviceOs": {
"type": "string",
"description": "The device operating system, for example `iOS`.\n\n**NOTE** Only available if the `DEVICE_INFO` extension is enabled in the appkey registration policy."
},
"deviceType": {
"type": "string",
"description": "The device type: identifies the device make and model.\n\n**NOTE** Only available if the `DEVICE_INFO` extension is enabled in the appkey registration policy."
},
"deviceName": {
"type": "string",
"description": "The device name: the device name if one has been registered by the device owner.\n\n**NOTE** Only available if the `DEVICE_INFO` extension is enabled in the appkey registration policy."
},
"notificationToken": {
"type": "string",
"description": "A push notification token provided by the device"
},
"invalidToken": {
"type": "boolean",
"description": "Present and true if the push notification token has been used for a previous push notification and is marked as unusable (invalid or unregistered)."
},
"preferredDevice": {
"type": "boolean",
"description": "Present and true if this is the preferred device to receive notifications for this app."
},
"rpId": {
"type": "string",
"description": "The relying party ID."
},
"aaid": {
"type": "string",
"description": "A unique identifier of the appkey type."
},
"keyId": {
"type": "string",
"description": "A unique identifier of the particular appkey credential."
},
"status": {
"type": "string",
"description": "The status of the appkey.",
"enum": [
"ACTIVE",
"DISABLED"
]
},
"lastAuthenticatedWithDtm": {
"type": "string",
"format": "date-time",
"description": "The time of the last authentication. If this appkey has not been used for authentication then this field is not present."
}
}
},
"BiometricSummary": {
"type": "object",
"description": "Summary information about a biometric registered to the user.",
"properties": {
"id": {
"type": "string",
"description": "The database identifier of the entity"
},
"createdDtm": {
"type": "string",
"format": "date-time"
},
"lastUpdatedDtm": {
"type": "string",
"format": "date-time"
},
"type": {
"type": "string",
"description": "The biometric type, for example `Face`"
},
"subtype": {
"type": "string",
"description": "The biometric subtype, for example an algorithm identifier like `DFV6E`"
},
"status": {
"type": "string",
"description": "The biometric status",
"enum": [
"PARTIAL_ENROLLMENT",
"ACTIVE",
"DISABLED"
]
},
"lastAuthenticatedWithDtm": {
"type": "string",
"format": "date-time",
"description": "The time of the last authentication. If this biometric has not been used for authentication then this field is not present."
}
}
},
"DeviceSummary": {
"type": "object",
"description": "Summary information about a device containing keys registered to the user.\n\n**NOTE** The device information is only available if the `DEVICE_INFO` extension is enabled in the appkey registration policy.",
"properties": {
"id": {
"type": "string",
"description": "A unique identifier of the device on which the keys are installed\n\n**NOTE** This is actually an identifier of the client application in which the appkey has been created. It is only available if the `DEVICE_INFO` extension s enabled in the appkey registration policy."
},
"rpId": {
"type": "string",
"description": "The relying party ID."
},
"os": {
"type": "string",
"description": "The device operating system, for example `iOS`.\n\n**NOTE** Only available if the `DEVICE_INFO` extension is enabled in the appkey registration policy."
},
"deviceType": {
"type": "string",
"description": "The device type: identifies the device model.\n\n**NOTE** Only available if the `DEVICE_INFO` extension is enabled in the appkey registration policy."
},
"name": {
"type": "string",
"description": "The device name: the device name if one has been registered by the device owner.\n\n**NOTE** Only available if the `DEVICE_INFO` extension is enabled in the appkey registration policy."
},
"notificationToken": {
"type": "string",
"description": "A push notification token provided by the device"
},
"invalidToken": {
"type": "boolean",
"description": "Present and true if the push notification token has been used for a previous push notification and is marked as unusable (invalid or unregistered)."
},
"preferredDevice": {
"type": "boolean",
"description": "Present and true if this is the preferred device to receive notifications for this app."
},
"keys": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"$ref": "#/$defs/AppkeySummary"
}
},
"description": "A map of appkey types to list of key summary information where the key types are:\n- **DEVICE**: A device appkey which authenticates the device without user input.\n- **BIOMETRIC**: A biometric appkey which authenticates the user using a biometric.\nList is here to support \"more than one app keys of the same type\" concept, but in most cases we expect the size of it will be one."
}
}
},
"PasscodeSummary": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The database identifier of the entity"
},
"createdDtm": {
"type": "string",
"format": "date-time"
},
"lastUpdatedDtm": {
"type": "string",
"format": "date-time"
},
"policyName": {
"type": "string",
"description": "Identifies the identity store passcode policy."
},
"status": {
"type": "string",
"description": "The status of the user passcode.",
"enum": [
"ACTIVE",
"DISABLED"
]
},
"lastRenewedDtm": {
"type": "string",
"format": "date-time",
"description": "The last time the passcode was renewed. Only present if a renewal has occurred."
},
"expirationDate": {
"type": "string",
"format": "date",
"description": "Expiration date for a passcode. Only required if regular renewals are enforced."
},
"lastAuthenticatedWithDtm": {
"type": "string",
"format": "date-time",
"description": "The time of the last authentication. If this passcode has not been used for authentication then this field is not present."
}
}
},
"PasskeySummary": {
"type": "object",
"description": "Summary information about a passkey registered to the user.",
"properties": {
"id": {
"type": "string",
"description": "The database identifier of the entity"
},
"createdDtm": {
"type": "string",
"format": "date-time"
},
"lastUpdatedDtm": {
"type": "string",
"format": "date-time"
},
"aaguid": {
"type": "string",
"description": "A unique identifier of the passkey type."
},
"credentialId": {
"type": "string",
"description": "A unique identifier of the particular passkey credential."
},
"status": {
"type": "string",
"description": "The status of the passkey.",
"enum": [
"ACTIVE",
"DISABLED"
]
},
"lastAuthenticatedWithDtm": {
"type": "string",
"format": "date-time",
"description": "The time of the last authentication. If this passkey has not been used for authentication then this field is not present."
},
"name": {
"type": "string",
"description": "The name of the passkey supplied when the passkey was registered."
}
}
},
"TOTPSummary": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The database identifier of the entity"
},
"createdDtm": {
"type": "string",
"format": "date-time"
},
"lastUpdatedDtm": {
"type": "string",
"format": "date-time"
},
"status": {
"type": "string",
"description": "The status of the user TOTP.",
"enum": [
"ACTIVE",
"PENDING",
"DISABLED"
]
},
"issuer": {
"type": "string",
"description": "The issuer of the user TOTP."
},
"username": {
"type": "string",
"description": "The user name label used for registering TOTP."
},
"policyName": {
"type": "string",
"description": "TOTP Policy name"
},
"algorithm": {
"type": "string",
"description": "The algorithm used to validate the authentication code."
},
"activatedDtm": {
"type": "string",
"format": "date-time",
"description": "Date and time of the TOTP activation - this is time when first auth with TOTP happened and marked TOTP as active."
},
"expirationDtm": {
"type": "string",
"format": "date-time",
"description": "Expiration dtm for the pending TOTPs - this is time before which is possible to activate pending TOTP."
},
"lastAuthenticatedWithDtm": {
"type": "string",
"format": "date-time",
"description": "The time of the last authentication. If this TOTP has not been used for authentication then this field is not present."
}
}
},
"TrustXLocale": {
"type": "object",
"description": "Locale information. Exposes the language, country and variant locale components, for example `en_US_UNIX` contains these components as `en`, `US` and `UNIX` respectively.",
"properties": {
"language": {
"type": "string",
"description": "The mandatory locale language component"
},
"country": {
"type": "string",
"description": "The optional locale country component"
},
"variant": {
"type": "string",
"description": "The optional locale variant component"
}
}
},
"UserDto": {
"type": "object",
"description": "A user in an identity store.",
"properties": {
"id": {
"type": "string",
"description": "Unique 26-character database user ID."
},
"storeName": {
"type": "string",
"description": "The name of the store in which this user resides."
},
"status": {
"type": "string",
"description": "The user's status: pending, active, locked or disabled.",
"enum": [
"PENDING_ACTIVE",
"ACTIVE",
"TEMP_LOCKED",
"LOCKED",
"DISABLED"
]
},
"extId": {
"type": "string",
"description": "A unique ID of the user supplied by the customer."
},
"type": {
"type": "string",
"description": "A user type supplied by the customer."
},
"locale": {
"$ref": "#/$defs/TrustXLocale",
"description": "The user's locale. The default locale configured at the store level."
},
"timezone": {
"type": "string",
"description": "The user's timezone. The default timezone configured at the store level."
},
"firstName": {
"type": "string",
"description": "The user's first name."
},
"lastName": {
"type": "string",
"description": "The user's last name."
},
"email": {
"type": "string",
"description": "The user's email address."
},
"dateOfBirth": {
"type": "string",
"format": "date",
"description": "The user's date of birth."
},
"nationalities": {
"type": "array",
"description": "A list of nationalities associated with the user.",
"items": {
"type": "string"
}
},
"attributes": {
"type": "object",
"additionalProperties": {
"type": "object"
},
"description": "A list of attributes associated with the user.\n\nOne attribute, which is set **internally** by the server on a user during passkey registration, is `passkeyUsers`. A specific user handle may be provided via the passkey registration request, if not it is set to a random ID when the first passkey is created for the user. The attribute value looks like this:.\n\n```\"passkeyUsers\": {\n \"{relyingPartyId}\": {\n \"USER_HANDLE\":\"{passkey user handle}\"\n }\n} \n```"
},
"summaryInfo": {
"$ref": "#/$defs/UserDtoSummaryInfo",
"description": "Summary information about items registered to the user."
},
"locks": {
"$ref": "#/$defs/UserLocks",
"description": "User lock information."
},
"lockedUntilDtm": {
"type": "string",
"format": "date-time",
"description": "If the user is currently locked, this is the time at which the lock will end."
},
"lastAuthenticatedDtm": {
"type": "string",
"format": "date-time",
"description": "If the user has been authenticated, this is the time at which they were last authenticated."
},
"createdDtm": {
"type": "string",
"format": "date-time"
},
"lastUpdatedDtm": {
"type": "string",
"format": "date-time"
}
}
},
"UserDtoSummaryInfo": {
"type": "object",
"description": "Summary information about items registered to the user such as biometrics, device keys and passkeys.",
"properties": {
"biometrics": {
"type": "array",
"items": {
"$ref": "#/$defs/BiometricSummary"
}
},
"passkeys": {
"type": "array",
"items": {
"$ref": "#/$defs/PasskeySummary"
}
},
"devices": {
"type": "array",
"items": {
"$ref": "#/$defs/DeviceSummary"
}
},
"totps": {
"type": "array",
"items": {
"$ref": "#/$defs/TOTPSummary"
}
},
"passcodes": {
"type": "array",
"items": {
"$ref": "#/$defs/PasscodeSummary"
}
}
}
},
"UserLocks": {
"type": "object",
"description": "User lock information.\n\nDescribes locks at the user level and modality level. A user can have escalating temporary locks which come into effect after a certain number of consecutive authentication attempts. The number of locks and the lock durations are configured at the store level.\n\n**NOTE**: Currently only user-level locking is supported with modality level locking planned for a later release.",
"properties": {
"lockCounter": {
"type": "integer",
"format": "int32",
"description": "The number of consecutive locks tagged for this user."
},
"tempLockedAt": {
"type": "string",
"format": "date-time",
"description": "If the user is *temporarily* locked then this is the time at which the lock came into effect."
},
"tempLockedUntil": {
"type": "string",
"format": "date-time",
"description": "If the user is *temporarily* locked then this is the time at which the lock ends."
},
"lockedAt": {
"type": "string",
"format": "date-time",
"description": "If the user is *permanently* locked then this is the time at which the lock came into effect."
},
"userModalityLocks": {
"type": "array",
"description": "Locking information related to particular authentication modalities.\n\n**Not supported in this release**",
"items": {
"$ref": "#/$defs/UserModalityLock"
}
}
}
},
"UserModalityLock": {
"type": "object",
"description": "Modality lock information.\n\nDescribes locks at the modality level. A modality can have escalating temporary locks which come into effect after a certain number of consecutive authentication attempts. The number of locks and the lock durations are configured at the store level.\n\n**NOTE**: Currently only user-level locking is supported with modality level locking planned for a later release.",
"properties": {
"lockCounter": {
"type": "integer",
"format": "int32",
"description": "The number of consecutive locks tagged for this modality."
},
"tempLockedAt": {
"type": "string",
"format": "date-time",
"description": "If the modality is *temporarily* locked then this is the time at which the lock came into effect."
},
"tempLockedUntil": {
"type": "string",
"format": "date-time",
"description": "If the modality is *temporarily* locked then this is the time at which the lock ends."
},
"lockedAt": {
"type": "string",
"format": "date-time",
"description": "If the modality is *permanently* locked then this is the time at which the lock came into effect."
},
"type": {
"type": "string",
"description": "The modality type, for example `Face`."
}
}
},
"UserTOTP": {
"type": "object",
"description": "A user TOTP record, created for every TOTP registration and updated with TOTP authentications.\n\n",
"properties": {
"permittedOperations": {
"type": "array",
"items": {
"type": "string"
}
},
"createdDtm": {
"type": "string",
"format": "date-time"
},
"lastUpdatedDtm": {
"type": "string",
"format": "date-time"
},
"id": {
"type": "string",
"description": "Unique 26-character database user ID."
},
"storeId": {
"type": "string",
"description": "Unique 26-character database store ID."
},
"userId": {
"type": "string",
"description": "Unique 26-character database user ID."
},
"status": {
"type": "string",
"description": "The totp status: ACTIVE, PENDING or DISABLED.",
"enum": [
"ACTIVE",
"PENDING",
"DISABLED"
]
},
"username": {
"type": "string",
"description": "Username for TOTP registration - used as a label in Authenticator App and identifies the account holder. Mandatory."
},
"policyName": {
"type": "string",
"description": "The TOTP policy name, used as a key in TOTP policies map in store configuration."
},
"algorithm": {
"type": "string",
"description": "The algorithm used to validate the authentication code. All of the algorithms from TOTP Policy will be tried and if one works, it will be set as the algorithm to TOTP record during complete TOTP registration process."
},
"issuer": {
"type": "string",
"description": "Issuer string, used as an identifier in Authenticator App, together with username from TOTP registration request. Optional, but highly recommended."
},
"secret": {
"type": "string",
"description": "The shared secret for TOTP"
},
"lastUsedDtm": {
"type": "string",
"format": "date-time",
"description": "If the TOTP has been used for authentication this field indicates the last time this occurred"
},
"expirationDtm": {
"type": "string",
"format": "date-time",
"description": "Expiration dtm for the pending TOTPs - this is time before which is possible to activate pending TOTP."
},
"activatedDtm": {
"type": "string",
"format": "date-time",
"description": "Date and time of the TOTP activation - this is time when first auth with TOTP happened and marked TOTP as active."
},
"typeId": {
"type": "string"
}
},
"required": [
"id",
"policyName",
"secret",
"status",
"storeId",
"userId",
"username"
]
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/daon-totpvalidation-result"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.