Skip to main content
GET
/
v2
/
customers
/
{customer_id}
Get Customer Details V2
curl --request GET \
  --url https://sandbox.api.fin.com/v2/customers/{customer_id} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "customer_id": "ed54db74-7dbe-47d2-8ea0-c2bf2a9dda06",
    "type": "BUSINESS",
    "business_name": "Fin.com",
    "email": "m@tech.com",
    "phone": "+8801529876543",
    "country_of_incorporation": "BGD",
    "verification_type": "STANDARD",
    "customer_status": "IN_COMPLIANCE",
    "tos_policies_url": "https://orchestration.fin.com/orchestration-customer-tos?customer_id=ed54db74-7dbe-47d2-8ea0-c2bf2a9dda06&tos_policies_value=6955e70b-f9f3-4076-b1ce-5c897085dd24",
    "associated_parties": [
      {
        "id": "f6b13e01-044a-4f74-a70b-d5f66b6449af",
        "type": "INDIVIDUAL",
        "ownership_percent": 60,
        "email": "fatima.rahman22@acmecorp.com.bd",
        "verification": {
          "status": "APPROVED",
          "reason": {
            "for_customer": null,
            "for_developer": null
          },
          "updated_at": "2026-04-13T11:40:49Z"
        }
      },
      {
        "id": "f71dc19f-b9a0-49fb-bd2d-5add3c01626e",
        "type": "INDIVIDUAL",
        "ownership_percent": 40,
        "email": "karim.islam22@acmecorp.com.bd",
        "verification": {
          "status": "APPROVED",
          "reason": {
            "for_customer": null,
            "for_developer": null
          },
          "updated_at": "2026-04-13T11:40:48Z"
        }
      }
    ],
    "created_at": "2026-04-13T11:38:57Z",
    "updated_at": "2026-04-13T11:40:51Z",
    "capabilities": {
      "on_ramp": [
        {
          "currency": "USD",
          "status": false,
          "methods": [
            "ACH",
            "FEDWIRE"
          ],
          "reason": {
            "for_customer": null,
            "for_developer": null
          }
        }
      ],
      "off_ramp": [
        {
          "currency": "USD",
          "status": false,
          "methods": [
            "ACH",
            "FEDWIRE",
            "ACH_SAME_DAY"
          ],
          "reason": {
            "for_customer": null,
            "for_developer": "Customer is under review"
          }
        },
        {
          "currency": "EUR",
          "status": false,
          "methods": [
            "BANK"
          ],
          "reason": {
            "for_customer": null,
            "for_developer": "Customer is under review"
          }
        },
        {
          "currency": "BDT",
          "status": false,
          "methods": [
            "BANK",
            "E_WALLET"
          ],
          "reason": {
            "for_customer": null,
            "for_developer": "Customer is under review"
          }
        },
        {
          "currency": "AUD",
          "status": false,
          "methods": [
            "BANK"
          ],
          "reason": {
            "for_customer": null,
            "for_developer": "Customer is under review"
          }
        },
        {
          "currency": "INR",
          "status": false,
          "methods": [
            "BANK"
          ],
          "reason": {
            "for_customer": null,
            "for_developer": "Customer is under review"
          }
        },
        {
          "currency": "JPY",
          "status": false,
          "methods": [
            "BANK"
          ],
          "reason": {
            "for_customer": null,
            "for_developer": "Customer is under review"
          }
        },
        {
          "currency": "NPR",
          "status": false,
          "methods": [
            "BANK"
          ],
          "reason": {
            "for_customer": null,
            "for_developer": "Customer is under review"
          }
        },
        {
          "currency": "CAD",
          "status": false,
          "methods": [
            "BANK"
          ],
          "reason": {
            "for_customer": null,
            "for_developer": "Customer is under review"
          }
        },
        {
          "currency": "PKR",
          "status": false,
          "methods": [
            "BANK"
          ],
          "reason": {
            "for_customer": null,
            "for_developer": "Customer is under review"
          }
        },
        {
          "currency": "PHP",
          "status": false,
          "methods": [
            "BANK"
          ],
          "reason": {
            "for_customer": null,
            "for_developer": "Customer is under review"
          }
        },
        {
          "currency": "SGD",
          "status": false,
          "methods": [
            "BANK"
          ],
          "reason": {
            "for_customer": null,
            "for_developer": "Customer is under review"
          }
        },
        {
          "currency": "GBP",
          "status": false,
          "methods": [
            "BANK"
          ],
          "reason": {
            "for_customer": null,
            "for_developer": "Customer is under review"
          }
        }
      ]
    },
    "rejection_reason": null,
    "request_for_information": []
  }
}

Authorizations

Authorization
string
header
required

Bearer token authentication. Obtain token from /v1/oauth/token endpoint

Path Parameters

customer_id
string<uuid>
required

Response

Customer details retrieved successfully

data
object