v1

latestOpenAPI 3.1.02026-07-226250251.5 KB
Customers

Get Customer Details V2

Retrieve detailed information for a specific customer

get/v2/customers/{customer_id}

Path parameters

customer_idstring uuid required

Response

Customer details retrieved successfully

Example response

{
  "data": {
    "customer_id": "56c41b8e-e650-4f55-94f6-26a888a9b64d",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "phone": "+14155551234",
    "country_of_residence": "USA",
    "verification_type": "STANDARD",
    "customer_status": "ACTION_REQUIRED",
    "tos_policies_url": "https://orchestration.fin.com/orchestration-customer-tos?customer_id=1f45e58d-0420-4ad8-a790-413169bfab28&tos_policies_value=ffefb0cd-4f0a-4585-ad1c-f4ea76ba41b8",
    "created_at": "2026-05-04T12:40:03Z",
    "updated_at": "2026-05-04T12:47:50Z",
    "last_status_updated_at": "2026-05-04T12:44:42.707598Z",
    "rejection_reason": {
      "applicant": {
        "reject_labels": [
          "EXPIRATION_DATE",
          "PROBLEMATIC_APPLICANT_DATA"
        ]
      },
      "documents": [
        {
          "uri": "/SuElNZpi_approved_passport_sumsub.jpg",
          "category": "PROOF_OF_IDENTITY",
          "moderation_comment": "Your identity document has expired and can't be used for verification. Please upload a different identity document.",
          "reject_labels": [
            "EXPIRATION_DATE"
          ]
        }
      ]
    },
    "request_for_information": []
  }
}