API reference

Applicants

The individuals and companies you verify.

List applicants

GET/v1/applicants

Scopes
applicants:read

Parameters

FieldTypeRequired
cursorquerystringno
limitqueryintegerno

Responses

  • 200ApplicantList
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Create an applicant

POST/v1/applicants

Scopes
applicants:write
Required header
Idempotency-Key

Request bodyApplicantCreate

FieldTypeRequired
typeenum: person, companyyes
external_idstringyes
personPersonInputno
companyCompanyInputno
metadataMetadatano
processing_context_idstring (uuid)yes

Responses

  • 201Applicant
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Get an applicant

GET/v1/applicants/{applicant_id}

Scopes
applicants:read

Parameters

FieldTypeRequired
applicant_idpathstring (uuid)yes

Responses

  • 200Applicant
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503

Update an applicant

PATCH/v1/applicants/{applicant_id}

Scopes
applicants:write
Required header
If-Match

Parameters

FieldTypeRequired
applicant_idpathstring (uuid)yes

Request bodyApplicantUpdate

FieldTypeRequired
personPersonInputno
companyCompanyInputno
metadataMetadatano

Responses

  • 200Applicant
  • 400
  • 401
  • 403
  • 404
  • 409
  • 412
  • 413
  • 415
  • 422
  • 428
  • 429
  • 503