API ReferenceKYB Requests

Get KYB request status

Returns the current status of a KYB request.

Authentication

Authorizationstring

Pass your API key as Api-Key <your_api_key> in the Authorization header. API keys are issued per Project by the TREVEX team.

Query parameters

request_idstringRequired

The request_id returned by create_claim.

Response

Status retrieved.
statusCodeinteger
request_idstring
statusenum
  • pending_verification — user has not yet verified their email
  • under_review — user is verified; awaiting admin decision
  • approved — admin approved the KYB request
  • rejected — admin declined the KYB request (can be resubmitted)
Allowed values:
company_namestring
submitted_atdatetime
ISO 8601 timestamp of when the KYB request was submitted.

Errors

404
Not Found Error