Get a customer

GET/customers/{customerId}

Returns a customer and its KYC details

Path Parameters

customerIdstringrequired

Response

OK

idstring<uuid>

Unique ID for the Customer KYC record created

namestring

Name of the Customer

emailstring<email>

Email of the customer

dobstring<date>

Date of Birth of the customer

genderstring

Gender of the Customer

country_codestring

Country Code for the Country of Customer

kyc_statusstring

KYC status of the Customer after the details are inspected. verified or blocked

kyc_tiernumber

Tier of the customer set based on KYC details provided

retries_leftinteger
poiobject[]
Show poi properties
idstring<uuid>
created_atstring<date-time>
statusstring

Verification status of uploaded POI. accepted declined pending waiting_for_upload

declined_reasonstring
transaction_limitstring

Amount allowed in each transaction (in SGD)

Invalid Customer ID

messagestring

Invalid/Expired Access Token

messagestring
errorsobject[]
Show errors properties
pathstring
messagestring

Not found

messagestring

Server Error

messagestring
Request
curl -X GET "https://api.triple-a.work/kyc-api/v1/customers/<customerId>" \
  -H "Authorization: Bearer <token>"
Response
{
  "id": "9598bb1a-4ce8-485b-a093-387656560624",
  "name": "John Doe",
  "email": "[email protected]",
  "dob": "1991-04-12",
  "gender": "Male",
  "country_code": "US",
  "kyc_status": "verified",
  "kyc_tier": 2,
  "retries_left": 1,
  "poi": [
    {
      "id": "a7d6016f-8b49-4e05-9a9c-08d4fc4e0644",
      "created_at": "2023-05-10T07:05:37.681Z",
      "status": "accepted",
      "declined_reason": null
    },
    {
      "id": "40d76a2e-7f39-46f5-924e-3a53af42e9b8",
      "created_at": "2023-05-03T05:52:03.821Z",
      "status": "declined",
      "declined_reason": "The document is expired, please upload a new document which is not expired"
    }
  ],
  "transaction_limit": "1500 SGD"
}