# Get Customer

## GET /v0/customers/{customer\_id}

> Get customer data

```json
{"openapi":"3.0.0","info":{"title":"Customers API","version":"0"},"servers":[{"url":"https://api.alignlabs.dev","description":"Production server"},{"url":"https://api-sandbox.alignlabs.dev","description":"Sandbox server"}],"paths":{"/v0/customers/{customer_id}":{"get":{"summary":"Get customer data","parameters":[{"name":"customer_id","in":"path","description":"The unique identifier of the customer","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Api-Key","in":"header","description":"Your secret API key, available in the developer dashboard. Include this header on every request to authenticate your application.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful retrieval of customer data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCustomerResponseSuccessModel"}}}}}}}},"components":{"schemas":{"GetCustomerResponseSuccessModel":{"type":"object","required":["customer_id","email","type"],"properties":{"customer_id":{"type":"string","format":"uuid","description":"The unique identifier for the customer"},"email":{"type":"string","format":"email","description":"The email address associated with the customer"},"company_name":{"type":"string","description":"The name of the company of the business customer"},"type":{"type":"string","enum":["individual","corporate"],"description":"The type of customer"},"first_name":{"type":"string","description":"The first name of the individual customer"},"last_name":{"type":"string","description":"The last name of the individual customer"},"address":{"type":"object","nullable":true,"description":"Customer address information. Only available for customers with approved KYC status.","properties":{"country":{"type":"string","description":"The country of the customer address"},"city":{"type":"string","description":"The city of the customer address"},"street_line_1":{"type":"string","description":"The street address line 1"},"postal_code":{"type":"string","description":"The postal code of the customer address"},"state":{"type":"string","description":"The state/province of the customer address"}}},"kycs":{"type":"object","nullable":true,"required":["status","kyc_flow_link","status_breakdown"],"properties":{"status":{"type":"string","nullable":true,"enum":["pending","approved","rejected"],"description":"Overall KYC verification status based on the general KYC verification"},"status_breakdown":{"type":"array","description":"Detailed KYC status breakdown by currency and payment rails","items":{"type":"object","required":["currency","payment_rails","status"],"properties":{"currency":{"type":"string","enum":["aed","eur","usd"],"description":"The fiat currency"},"payment_rails":{"type":"string","enum":["uaefts","sepa","ach","wire"],"description":"The payment rails type"},"status":{"type":"string","enum":["pending","approved"],"description":"The KYC verification status for this currency and payment rails combination"}}}},"sub_status":{"type":"string","description":"Current sub-status of the KYC verification process when status is 'pending':\n* kyc_form_submission_started - Customer has initiated the KYC process and started filling out their details\n* kyc_form_submission_accepted - Customer has successfully completed the KYC flow and their documents have been accepted\n* kyc_form_resubmission_required - Additional information or documents needed after internal review, customer should use the same kyc_flow_link to resubmit\n","enum":["kyc_form_submission_started","kyc_form_submission_accepted","kyc_form_resubmission_required"]},"kyc_flow_link":{"type":"string"}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.alignlabs.dev/align-api/customers/get-customer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.