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"
}
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"