v50

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-04-145745483.2 KB
VerifyV2Factor

Fetch a specific Factor.

Fetch a specific Factor.

get/v2/Services/{ServiceSid}/Entities/{Identity}/Factors/{Sid}

Path parameters

ServiceSidstring required

The unique SID identifier of the Service.

Identitystring required

Customer unique identity for the Entity owner of the Factor. This identifier should be immutable, not PII, length between 8 and 64 characters, and generated by your external system, such as your user's UUID, GUID, or SID. It can only contain dash (-) separated alphanumeric characters.

Sidstring required

A 34 character string that uniquely identifies this Factor.

Response

OK

sidstring nullable

A 34 character string that uniquely identifies this Factor.

account_sidstring nullable

The unique SID identifier of the Account.

service_sidstring nullable

The unique SID identifier of the Service.

entity_sidstring nullable

The unique SID identifier of the Entity.

identitystring nullable

Customer unique identity for the Entity owner of the Factor. This identifier should be immutable, not PII, length between 8 and 64 characters, and generated by your external system, such as your user's UUID, GUID, or SID. It can only contain dash (-) separated alphanumeric characters.

date_createdstring date-time nullable

The date that this Factor was created, given in ISO 8601 format.

date_updatedstring date-time nullable

The date that this Factor was updated, given in ISO 8601 format.

friendly_namestring nullable

A human readable description of this resource, up to 64 characters. For a push factor, this can be the device's name.

status'unverified' | 'verified'

The Status of this Factor. One of unverified or verified.

factor_type'push' | 'totp' | 'passkeys'

The Type of this Factor. Currently push and totp are supported.

{"stackTrail":"components:schemas:verify.v2.service.entity.factor:properties:config","oasType":"schema","type":"unknown","description":"An object that contains configurations specific to a `factor_type`.","nullable":true}
{"stackTrail":"components:schemas:verify.v2.service.entity.factor:properties:metadata","oasType":"schema","type":"unknown","description":"Custom metadata associated with the factor. This is added by the Device/SDK directly to allow for the inclusion of device information. It must be a stringified JSON with only strings values eg. `{\"os\": \"Android\"}`. Can be up to 1024 characters in length.","extensionFields":{"x-twilio":{"pii":{"handling":"standard","deleteSla":30}}},"nullable":true}
urlstring uri nullable

The URL of this resource.