Skip to main content
POST
Registration by Descent Certificate

Authorizations

x-api-key
string
header
required

Use your API key in the x-api-key header.

Headers

Accept
string
default:application/json
Content-Type
string
default:application/json
x-api-key
string
required
Example:

"{your_api_key}"

Body

application/json
FamilyName
string
required

Family name on the certificate.

Example:

"Smith"

BirthDate
object
required
StockNumber
string
required

Certificate stock number.

Example:

"123456789"

AcquisitionDate
string
required

Date citizenship was acquired.

Example:

"2020-01-15"

GivenName
string

Given name(s) on the certificate.

Example:

"John"

VerificationRequestNumber
string

Your unique identifier for this verification request. Defaults to a system-generated UUID if omitted.

Example:

"VI-01-01"

Response

200 - application/json

Request processed. Check VerificationResultCode to determine whether the verification was valid (1) or invalid (2); Errors is present only when invalid.

ActivityId
string

Unique identifier assigned by DVS to this verification activity.

Example:

"5a1626e0-272f-4a64-b085-1068a877701d"

OriginatingAgencyCode
string

Code of the agency that originated the verification request.

Example:

"IDM001"

VerificationRequestNumber
string

Echo of the request's VerificationRequestNumber.

Example:

"VI-01-01"

VerificationResultCode
enum<integer>

Result of the verification. 1 = Valid, 2 = Invalid.

Available options:
1,
2
Example:

1

Errors
object[]

Present only when the verification is invalid.