Skip to main content
GET
/
customers
/
{customer_id}
Retrieve Customer
curl --request GET \
  --url https://api-sandbox.y.uno/v1/customers/{customer_id} \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>'
{
  "id": "94121f98-98f7-4d57-aa5f-228401d35b12",
  "merchant_customer_id": "1744402154",
  "first_name": "John",
  "last_name": "Doe",
  "gender": "F",
  "date_of_birth": "1990-02-28",
  "email": "john.doe@gmail.com",
  "nationality": "CO",
  "country": "CO",
  "document": {
    "document_type": "CC",
    "document_number": "1010268952"
  },
  "phone": {
    "number": "3132450765",
    "country_code": "57"
  },
  "billing_address": {
    "address_line_1": "Calle 34 # 56 - 78",
    "address_line_2": "Apartamento 502, Torre I",
    "country": "CO",
    "state": "Cundinamarca",
    "city": "Bogotá",
    "zip_code": "111111",
    "neighborhood": "Test"
  },
  "shipping_address": {
    "address_line_1": "Calle 34 # 56 - 78",
    "address_line_2": "Apartamento 502, Torre I",
    "country": "CO",
    "state": "Cundinamarca",
    "city": "Bogotá",
    "zip_code": "111111",
    "neighborhood": "Test"
  },
  "metadata": [
    {
      "key": "ID",
      "value": "1234"
    }
  ],
  "created_at": "2025-04-11T20:09:14.927971Z",
  "updated_at": "2025-04-11T20:09:14.927972Z",
  "merchant_customer_created_at": "2023-08-05T14:43:58.980718Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.y.uno/llms.txt

Use this file to discover all available pages before exploring further.

This request enables you to retrieve details of customers based on their id, which needs to be provided in the request path.

Authorizations

​
public-api-key
string
header
default:<Your public-api-key>
required
​
private-secret-key
string
header
default:<Your private-secret-key>
required

Path Parameters

​
customer_id
string
required

Response

200

​
id
string
Example:

"94121f98-98f7-4d57-aa5f-228401d35b12"

​
merchant_customer_id
string
Example:

"1744402154"

​
first_name
string
Example:

"John"

​
last_name
string
Example:

"Doe"

​
gender
string
Example:

"F"

​
date_of_birth
string
Example:

"1990-02-28"

​
email
string
Example:

"john.doe@gmail.com"

​
nationality
string
Example:

"CO"

​
country
string
Example:

"CO"

​
document
object
​
phone
object
​
billing_address
object
​
shipping_address
object
​
metadata
object[]
​
created_at
string
Example:

"2025-04-11T20:09:14.927971Z"

​
updated_at
string
Example:

"2025-04-11T20:09:14.927972Z"

​
merchant_customer_created_at
string
Example:

"2023-08-05T14:43:58.980718Z"