Skip to main content
GET
/
v1
/
customers
/
{customer_id}
Get Customer Details
curl --request GET \
  --url https://sandbox.api.fin.com/v1/customers/{customer_id} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "customer_id": "56c41b8e-e650-4f55-94f6-26a888a9b64d",
    "type": "INDIVIDUAL",
    "first_name": "Omran",
    "last_name": "Jamal",
    "email": "[email protected]",
    "phone": "+14724480512",
    "country_of_residence": "USA",
    "verification_type": "STANDARD",
    "customer_status": "INCOMPLETE",
    "tos_policies_url": "https://orchestration.fin.com/orchestration-customer-tos?customer_id=56c41b8e-e650-4f55-94f6-26a888a9b64d&tos_policies_value=a93d34a1-fc39-48a1-afdb-fd5c4607c5df",
    "created_at": "2025-12-22T06:41:18Z",
    "updated_at": "2025-12-22T06:41:28Z",
    "capabilities": {
      "on_ramp": [
        {
          "currency": "USD",
          "status": false,
          "methods": [
            "ACH",
            "FEDWIRE"
          ],
          "reason": {
            "for_customer": "<string>",
            "for_developer": "<string>"
          }
        }
      ],
      "off_ramp": [
        {
          "currency": "USD",
          "status": false,
          "methods": [
            "ACH",
            "FEDWIRE",
            "ACH_SAME_DAY"
          ],
          "reason": {
            "for_customer": "<string>",
            "for_developer": "Complete verification"
          }
        }
      ]
    }
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

customer_id
string<uuid>
required

Unique identifier for the customer

Response

Customer details retrieved successfully

data
object