Loading

DFS OTP Services API (latest)

Download OpenAPI specification:Download

Contains functionality around OTP (one time password) services.

For endpoints that support localization the language can be passed either as a query string parameter (using the name 'language') or in the 'accept-language' header.
If no language is passed to such endpoints then the default configured language will be used.

ContactVerification

Verify a one-time verification code

Verifies a one-time verification code sent to the contact under the context of a specific session.

Authorizations:
path Parameters
contactId
required
integer <int32>

Contact id

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

Verify verification key request

key
string Nullable
sessionId
string Nullable

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

UnprocessableEntity

500

Server Error

post/v1.0/contacts/{contactId}/verification-key/verify
https://example-host/v1.0/contacts/{contactId}/verification-key/verify

Request samples

Content type
Copy
Expand all Collapse all
{
  • "key": "string",
  • "sessionId": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "code": "BadRequest",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Send a one-time verification code

Sends a one-time verification code to the contact in a specific channel. If a sessionId is not specified, a generated sessionId would be returned (to be used when verifying the key).

Authorizations:
path Parameters
contactId
required
integer <int32>

Contact ID.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

Send verification key request.

sessionId
string Nullable
channel
string (VerificationChannelKey)
Enum: "Sms" "Email"
templateMetadataKey
string Nullable

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

422

UnprocessableEntity

500

Server Error

post/v1.0/contacts/{contactId}/verification-key/send
https://example-host/v1.0/contacts/{contactId}/verification-key/send

Request samples

Content type
Copy
Expand all Collapse all
{
  • "sessionId": "string",
  • "channel": "Sms",
  • "templateMetadataKey": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "generatedSessionId": "string"
}