Get full KYB request detail

curl -G https://api.trevex.io/apis/email/claim_detail/ \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d request_id=request_id

{
  "statusCode": 200,
  "request_id": "REQ-20240115-987654",
  "status": "approved",
  "company_name": "GreenTech Innovations LLC",
  "submitted_at": "2024-01-10T14:22:00Z",
  "claim_data": {
    "company_registration_number": "GTI-2023-4589",
    "applicant_name": "Alice Johnson",
    "email": "alice.johnson@greentech.com",
    "phone": "+1-555-123-4567",
    "address": "1234 Elm Street, Springfield, IL, 62704",
    "industry": "Renewable Energy",
    "documents_submitted": [
      "trade_license.pdf",
      "authorized_signatory_id.pdf"
    ]
  },
  "verification": {
    "trevex_company_id": "TRXAE0000042",
    "approved_at": "2024-01-15T09:30:00Z",
    "verification_scope": {
      "company_existence_verified": true,
      "trade_license_submitted": true,
      "authorized_signatory_submitted": true,
      "ownership_confirmed": true
    },
    "note": "All documents verified and ownership confirmed."
  }
}

Returns full details of a KYB request. When the request is approved, the response includes a verification object with the audit scope.

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

KYB request detail 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

claim_datamap from strings to any

Full snapshot of the submitted KYB request payload.

verificationobject

Only present when status is approved and a company record is linked.

Errors

404

Not Found Error