---
title: "Fetch Entity"
method: GET
path: "/v3/entity/{id}"
---

# Fetch Entity

`GET /v3/entity/{id}`

## Path parameters

- `id` string, required

## Response `200`

200

- object
  - `status` string — Indicates the result of the API call.
  - `message` string — Optional message providing context or additional information about the response. Can be empty.
  - `data` object — Details of the entity or KYB record returned in the response.
    - `approval_status` string — Current approval status of the entity record.
    - `approval_status_description` string — Additional description or remarks regarding the approval status.
    - `approved_at` string — Timestamp when the entity was approved (ISO 8601 format). Can be null if not yet approved.
    - `created_at` string — Timestamp when the entity record was created (ISO 8601 format).
    - `description` string — Description or additional information about the entity.
    - `documents` object[] — List of documents associated with this entity, such as proof of address or identity.
      - `description` string
      - `document_id` string
      - `file_name` string
      - `sub_type` string
      - `tag` string
      - `type` string
      - `updated_at` string
      - `url` string
    - `email` string — Email address associated with the entity. May be empty.
    - `id` string — Unique identifier for the entity record.
    - `metadata` Metadata, nullable — Custom metadata key-value pairs attached to the object
    - `name` string — Name of the entity or individual.
    - `object` string
    - `on_behalf_of` string — Identifier of another entity on whose behalf this record is created, if applicable.
    - `onboarding_package_url` string — Link to the onboarding package for this entity. May be empty.
    - `operating_address` string — Operating address details for the entity. May be null or empty if not provided.
    - `pending_documents` object[] — List of documents pending submission or verification.
    - `phone` Phone — Phone contact details
      - `calling_code` string — Calling country code (for example, '1' for United States, '91' for India)
      - `number` string — Phone Number
    - `purpose_of_use` string[] — List of purposes for which the entity account is used.
    - `reference_id` string — External reference identifier linked to this entity.
    - `registration_address` Address — Address details
      - `line1` string — Address Line 1
      - `line2` string — Address Line 2
      - `city` string — Address city
      - `state` string — Address state
      - `country` string — Address country (ISO 3166-1 alpha-2 country code)
      - `postal_code` string — Postal Code
    - `registration_date` string — Date of business registration or incorporation. May be empty.
    - `registration_number` string — Official registration number of the entity.
    - `rejected_at` string — Timestamp when the entity was rejected, if applicable. May be null or empty.
    - `relationship` string — Defines the relationship type of this entity (e.g., customer, partner).
    - `representatives` object[] — List of authorized representatives associated with the entity, such as directors, beneficial owners, or shareholders.
      - `person_id` string — Unique identifier for the representative.
      - `first_name` string — The first name of the representative.
      - `last_name` string — The last name of the representative.
      - `date_of_birth` string — Date of birth of the representative (ISO 8601).
      - `address` Address — Address details
        - `line1` string — Address Line 1
        - `line2` string — Address Line 2
        - `city` string — Address city
        - `state` string — Address state
        - `country` string — Address country (ISO 3166-1 alpha-2 country code)
        - `postal_code` string — Postal Code
      - `nationality` string — Two-letter ISO country code for nationality.
      - `phone` Phone — Phone contact details
        - `calling_code` string — Calling country code (for example, '1' for United States, '91' for India)
        - `number` string — Phone Number
      - `ownership_percentage` number — The ownership percentage held by this representative in the entity.
      - `roles` string[] — Roles or designations of the representative within the entity.
      - `documents` object[] — List of documents submitted for this representative.
        - `description` string
        - `document_id` string
        - `file_name` string
        - `sub_type` string
        - `tag` string
        - `type` string
        - `updated_at` string
        - `url` string
    - `source_of_wealth` string — Details of the entity’s source of wealth, if applicable. May be empty.
    - `statement_descriptor` string — Custom statement descriptor for this entity’s transactions.
    - `submit` boolean — Indicates whether the KYB submission has been completed.
    - `submitted_at` string — Timestamp when the entity submission was made.
    - `tax_id` string — Tax identification number of the entity.
    - `type` string — Type of entity (e.g., individual, business).
    - `vertical` string — Industry vertical of the entity, if specified.
    - `website` string — Website URL of the entity.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/tazapay/apis/sandbox.md) · [All operations](https://skmtc.net/tazapay/apis/sandbox/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tazapay/sandbox/versions/bf5f4b8f6f5d/schema)