Get Customer

POST 
/customer

Retrieves information for an existing customer to personalize the checkout for them.

Request

application/json

Body

required

request_id uuidrequired

A unique identifier to track this request

email string

Email submitted by the customer during the checkout process

session_id string

Session ID passed through via the SDK checkout request to identify existing sessions

Responses

200

OK

application/json

Schema

Schema

request_id uuid

customer

object

first_name string

last_name string

email string

addresses

object[]

Array [

first_name string

last_name string

phone string

street stringrequired

city stringrequired

postcode stringrequired

region string

country stringrequired

notes string

dni string

]

loyalty_profile

object

member_since date

current_points_balance int64

tier string

Example (from schema)

{
  "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "customer": {
    "first_name": "string",
    "last_name": "string",
    "email": "string"
  },
  "addresses": [
    {
      "first_name": "string",
      "last_name": "string",
      "phone": "string",
      "street": "string",
      "city": "string",
      "postcode": "string",
      "region": "string",
      "country": "string",
      "notes": "string",
      "dni": "string"
    }
  ],
  "loyalty_profile": {
    "member_since": "2024-07-29",
    "current_points_balance": 0,
    "tier": "string"
  }
}

Example

{
  "request_id": "d1280b05-ca5c-4af2-8dcb-6ae81572dcba",
  "customer": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "test@simpler.so"
  },
  "addresses": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "phone": "+4412345678",
      "street": "128 City Road",
      "city": "London",
      "postcode": "EC1V 2NX",
      "country": "GB"
    }
  ],
  "loyalty_profile": {
    "member_since": "2025-05-01",
    "current_points_balance": 1500,
    "tier": "Platinum"
  }
}

400

Bad Request

401

Unauthorized

Loading...