Signatures
MFA Verify
Verifies the code sent as part of the multi-factor authentication (MFA) process.
- Use this endpoint to confirm the authentication code received via phone or email.
AuthorizationBearer <token>
JWT token to authenticate the request.
In: header
X-Api-Key<token>
API key, sent as a request header.
In: header
Query Parameters
tid?string
Transaction token identifying a specific recipient+envelope pair. Required for anonymous/recipient access (no Authorization header, or the header doesn't resolve to the envelope owner).
Format
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/signatures/mfa/verify" \ -H "Content-Type: application/json" \ -d '{ "recipient": { "code": "string" }, "externalContext": {} }'{ "result": { "statusCode": 200, "message": "OK", "data": { "recipient": { "method": "email", "destination": { "email": "name@example.com" }, "message": "Thank you for completing this document." } } }, "origin": "POST https://api.doctavian.com/v1/signatures/mfa/verify", "dateTime": "2026-07-20T12:00:00.000Z", "userId": "314d361d-2756-418e-acd2-2bfd6cfbe98e"}{ "error": { "message": "Envelope not found.", "statusCode": 400, "innerErrors": [ { "code": "ENVELOPE_ID_INVALID", "message": "Envelope not found.", "userMessage": "Envelope not found." } ] }, "origin": "POST https://api.doctavian.com/v1/signatures/mfa/verify", "dateTime": "2026-07-20T12:00:00.000Z", "userId": "898e268b-9a5c-4967-943d-f7f36f4c2d6f", "operationId": "3861c75177705ca9d04ddfb2a8d20124"}{ "error": { "message": "Envelope not found.", "statusCode": 500, "innerErrors": [ { "code": "ENVELOPE_ID_INVALID", "message": "Envelope not found.", "userMessage": "Envelope not found." } ] }, "origin": "POST https://api.doctavian.com/v1/signatures/mfa/verify", "dateTime": "2026-07-20T12:00:00.000Z", "userId": "37472056-04bc-48c0-a544-7f165b96cbe3", "operationId": "fd0b97e996e678d006eb9a32035f6798"}