Download OpenAPI specification:Download
The Credentials resources let you upload credentials and execute workflows.
Note that each Credential request requires a token that you generate through an Authorization call before starting the session.
Updates a specified part of a credential for a given account.
| accountId required | string <uuid> Example: bbf3a261-9bf9-400c-b218-cd275596d8d9 Unique account identifier. |
| workflowExecutionId required | string <uuid> Unique workflow identifier. |
| credentialId required | string <uuid> Unique identifier for the credential. |
| classifier required | string FRONT, BACK, FACE |
| User-Agent required | string Value for the User-Agent header |
| Authorization required | string OTP token received in response to account create / update. |
| file | string <binary> JPEG, PNG (max. size 15 MB and max resolution of 8000 x 8000) |
{- "timestamp": "2019-08-24T14:15:22Z",
- "account": {
- "id": "bbf3a261-9bf9-400c-b218-cd275596d8d9"
}, - "workflowExecution": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "credential": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "part": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "api": {
- "token": "string",
- "parts": {
- "property1": {
- "1": "href",
- "2": "href"
}, - "property2": {
- "1": "href",
- "2": "href"
}
},
}
}Adds a part to the specified account credential.
| accountId required | string <uuid> Example: bbf3a261-9bf9-400c-b218-cd275596d8d9 Unique account identifier. |
| workflowExecutionId required | string <uuid> Unique identifier of the workflow associated with the target credential. |
| credentialId required | string <uuid> Unique identifier of the credential the part will be added to. |
| classifier required | string Example: BACK The part classifier. |
| User-Agent required | string Value for the User-Agent header |
| Authorization required | string OTP token returned by the account create / update request. |
| file | string <binary> JPEG, PNG (max. size 15 MB and max resolution of 8000 x 8000. Longest side must be > 300px.) |
{- "timestamp": "2019-08-24T14:15:22Z",
- "account": {
- "id": "bbf3a261-9bf9-400c-b218-cd275596d8d9"
}, - "workflowExecution": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "credential": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "part": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "api": {
- "token": "string",
- "parts": {
- "property1": {
- "1": "href",
- "2": "href"
}, - "property2": {
- "1": "href",
- "2": "href"
}
},
}
}| accountId required | string <uuid> Example: bbf3a261-9bf9-400c-b218-cd275596d8d9 Unique account identifier. |
| workflowExecutionId required | string <uuid> Unique workflow identifier. |
| credentialId required | string <uuid> Unique ID of the credential |
| User-Agent required | string Value for the User-Agent header |
| Authorization required | string OTP token returned by the account create / update request. |
{- "timestamp": "2019-08-24T14:15:22Z",
- "account": {
- "id": "bbf3a261-9bf9-400c-b218-cd275596d8d9"
}, - "workflowExecution": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "credential": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "part": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "api": {
- "token": "string",
- "parts": {
- "property1": {
- "1": "href",
- "2": "href"
}, - "property2": {
- "1": "href",
- "2": "href"
}
},
}
}Uploads a specified document (image(s)/single pdf).
| accountId required | string <uuid> Example: bbf3a261-9bf9-400c-b218-cd275596d8d9 Unique account identifier. |
| workflowExecutionId required | string <uuid> Unique workflow identifier. |
| credentialId required | string <uuid> Unique credential identifier |
| User-Agent required | string Value for the User-Agent header |
| Authorization required | string OTP token returned by the account create / update request. |
| file | string <binary> |
{- "timestamp": "2019-08-24T14:15:22Z",
- "account": {
- "id": "bbf3a261-9bf9-400c-b218-cd275596d8d9"
}, - "workflowExecution": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "credential": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "part": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "api": {
- "token": "string",
- "parts": {
- "property1": {
- "1": "href",
- "2": "href"
}, - "property2": {
- "1": "href",
- "2": "href"
}
},
}
}Finalize the acquisition process and start the workflow.
| accountId required | string <uuid> Example: bbf3a261-9bf9-400c-b218-cd275596d8d9 Unique account identifier. |
| workflowExecutionId required | string <uuid> Unique workflow identifier. |
| User-Agent required | string Value for the User-Agent header |
| Authorization required | string OTP token which has been received on the account create update |
{- "timestamp": "2019-08-24T14:15:22Z",
- "account": {
- "id": "bbf3a261-9bf9-400c-b218-cd275596d8d9"
}, - "workflowExecution": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "credential": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "part": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "api": {
- "token": "string",
- "parts": {
- "property1": {
- "1": "href",
- "2": "href"
}, - "property2": {
- "1": "href",
- "2": "href"
}
},
}
}Deletes a specified part of a credential for a given account.
IMPORTANT: Deleted data is not retrievable. Contact support for more details on data retention configuration options.
| accountId required | string <uuid> Example: bbf3a261-9bf9-400c-b218-cd275596d8d9 Unique account identifier. |
| workflowExecutionId required | string <uuid> Unique identifier of a particular instance of workflow execution. |
| credentialId required | string <uuid> Unique identifier of the credential containing the part to be deleted. |
| classifier required | string Classifier of the part to be deleted. |
| User-Agent required | string Value for the User-Agent header |
| Authorization required | string OTP token returned by account create / update |
{- "timestamp": "2019-08-24T14:15:22Z",
- "account": {
- "id": "bbf3a261-9bf9-400c-b218-cd275596d8d9"
}, - "workflowExecution": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "credential": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "part": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "api": {
- "token": "string",
- "parts": {
- "property1": {
- "1": "href",
- "2": "href"
}, - "property2": {
- "1": "href",
- "2": "href"
}
},
}
}Delete all pages.
IMPORTANT: Deleted data is not retrievable. Contact support for more details on data retention configuration options.
| accountId required | string <uuid> Example: bbf3a261-9bf9-400c-b218-cd275596d8d9 Unique account identifier. |
| workflowExecutionId required | string <uuid> Unique workflow identifier. |
| credentialId required | string <uuid> Unique credential identifier. |
| User-Agent required | string Value for the User-Agent header |
| Authorization required | string OTP token returned by the account create / update request. |
{- "timestamp": "2019-08-24T14:15:22Z",
- "account": {
- "id": "bbf3a261-9bf9-400c-b218-cd275596d8d9"
}, - "workflowExecution": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "credential": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "part": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "api": {
- "token": "string",
- "parts": {
- "property1": {
- "1": "href",
- "2": "href"
}, - "property2": {
- "1": "href",
- "2": "href"
}
},
}
}