Skip to main content
GET
/
v3
/
entity
/
{id}
Fetch Entity
curl --request GET \
  --url https://service-sandbox.tazapay.com/v3/entity/{id} \
  --header 'Authorization: Basic <encoded-value>'
"   \"status\": \"success\",\n    \"message\": \"\",\n    \"data\": {\n        \"approval_status\": \"approved\",\n        \"approval_status_description\": \"Approved for payouts only\",\n        \"approved_at\": \"2025-10-09T02:55:52.284767Z\",\n        \"created_at\": \"2025-10-08T05:18:11.700575Z\",\n        \"description\": \"\",\n        \"documents\": [\n            {\n                \"description\": \"Recent utility bill\",\n                \"document_id\": \"doc_d3iv85v58tg9dlpipu2g\",\n                \"file_name\": \"kyb_doc82697_2October2025_202590_894374483.pdf\",\n                \"sub_type\": \"other\",\n                \"tag\": \"\",\n                \"type\": \"address\",\n              \t\"updated_at\": \"2025-09-08T05:18:15.228195Z\",\n\t\t\t\t\t\t\t\t\"url\": \"https://s3.ap-southeast-1.amazonaws.com/tazapay-test-doc\"\n            },\n            {\n                \"description\": \"Passport front\",\n                \"document_id\": \"doc_d3iv85v58tg9dlpipu1g\",\n                \"file_name\": \"kyb_doc10723_8October2025_docapture_manual-6.jpg\",\n                \"sub_type\": \"passport\",\n                \"tag\": \"identityProofTypeFrontDoc\",\n                \"type\": \"identity\",\n                \"updated_at\": \"2025-10-08T05:18:15.228195Z\",\n\t\t\t\t\t\t\t\t\"url\": \"https://s3.ap-southeast-1.amazonaws.com/tazapay-test-doc\"\n\n            },\n            {\n                \"description\": \"Passport back\",\n                \"document_id\": \"doc_d3iv85v58tg9dlpipu20\",\n                \"file_name\": \"kyb_doc38625_8October2025_docapture_manual-6.jpg\",\n                \"sub_type\": \"passport\",\n                \"tag\": \"identityProofTypeBackDoc\",\n                \"type\": \"identity\",\n                \"updated_at\": \"2025-10-08T05:18:15.228195Z\",\n\t\t\t\t\t\t\t\t\"url\": \"https://s3.ap-southeast-1.amazonaws.com/tazapay-test-doc\"\n\n            }\n        ],\n        \"email\": \"\",\n        \"id\": \"ent_d3iv84vs8ud68hm8dba40\",\n        \"metadata\": {},\n        \"name\": \"James Brwon\",\n        \"object\": \"entity\",\n        \"on_behalf_of\": \"\",\n        \"onboarding_package_url\": \"\",\n        \"operating_address\": null,\n        \"pending_documents\": [],\n        \"phone\": {\n            \"calling_code\": \"\",\n            \"number\": \"\"\n        },\n        \"purpose_of_use\": [\n            \"payout\"\n        ],\n        \"reference_id\": \"\",\n        \"registration_address\": {\n            \"city\": \"Bangkok\",\n            \"country\": \"TH\",\n            \"line1\": \"151/1 Richmond Boulevard, Lumpini\",\n            \"line2\": \"\",\n            \"postal_code\": \"10330\",\n            \"state\": \"Pathumwan\"\n        },\n        \"registration_date\": \"\",\n        \"registration_number\": \"\",\n        \"rejected_at\": null,\n        \"relationship\": \"customer\",\n        \"representatives\": [],\n        \"source_of_wealth\": null,\n        \"statement_descriptor\": \"\",\n        \"submit\": true,\n        \"submitted_at\": \"2025-10-01T05:18:15.228732Z\",\n        \"tax_id\": \"\",\n        \"type\": \"individual\",\n        \"vertical\": \"\",\n        \"website\": \"\"\n    }\n}"

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

id
string
required

Tazapay unique ID for the entity

Response

200

status
string

Indicates the result of the API call.

Example:

"success"

message
string

Optional message providing context or additional information about the response. Can be empty.

Example:

""

data
object

Details of the entity or KYB record returned in the response.