---
title: "Get a single customer"
method: GET
path: "/customers/{id}"
tags: ["Customers"]
---

# Get a single customer

`GET /customers/{id}`

## Request

- Base URL: `https://example.retail.lightspeed.app/api/2026-10`
- URL: `https://example.retail.lightspeed.app/api/2026-10/customers/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lightspeedhq/apis/lightspeedhq/docs/customers/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a single customer with a requested ID.

🔒 Requires: `customers:read` scope

## Path parameters

- `id` string, required

## Response `200`

- CustomerResponse
  - `data` Customer
    - `balance` number, double: Customer's unpaid balance.
    - `company_name` string, nullable: Company name.
    - `created_at` string: Creation timestamp in UTC.
    - `custom_field_1` string, nullable: Custom field 1. Can be used to store random data.
    - `custom_field_2` string, nullable: Custom field 2.
    - `custom_field_3` string, nullable: Custom field 3.
    - `custom_field_4` string, nullable: Custom field 4.
    - `customer_code` string: Customer code used for claiming loyalty.
    - `customer_group_id` string: Customer group ID.
    - `date_of_birth` string, nullable: Birthday.
    - `deleted_at` string, nullable: Deletion timestamp in UTC.
    - `do_not_email` boolean: Indicates whether the customer opted out of email communications.
    - `email` string, nullable: Customer's email address.
    - `enable_loyalty` boolean
    - `enable_promotional_sms` boolean: Indicates whether the customer opted in to SMS communications.
    - `fax` string, nullable: Fax no.
    - `first_name` string, nullable, required: Customer's first name.
    - `gender` string, nullable: Customer's gender. Can be `M`, `F` or null.
    - `id` string: Auto-generated object ID.
    - `last_name` string, nullable, required: Customer 's last name.
    - `loyalty_balance` number, double: Customer's loyalty balance.
    - `mobile` string, nullable: Mobile phone no.
    - `name` string, nullable: Customers full name. **deprecated**
    - `note` string, nullable: Customer note.
    - `on_account_limit` number, double, nullable: Customer's OnAccount Limit.
    - `phone` string, nullable: Phone no.
    - `physical_address_1` string, nullable: Physical address, line 1.
    - `physical_address_2` string, nullable: Physical address, line 2.
    - `physical_city` string, nullable: Physical address, city.
    - `physical_country_id` string, nullable: Physical address, country code.
    - `physical_postcode` string, nullable: Physical address, post code.
    - `physical_state` string, nullable: Physical address, state.
    - `physical_suburb` string, nullable: Physical address, suburb.
    - `postal_address_1` string, nullable: Postal address, line 1.
    - `postal_address_2` string, nullable: Postal address, line 2.
    - `postal_city` string, nullable: Postal address, city.
    - `postal_country_id` string, nullable: Postal address, country code.
    - `postal_postcode` string, nullable: Postal address, post code.
    - `postal_state` string, nullable: Postal address, state.
    - `postal_suburb` string, nullable: Postal address, suburb.
    - `tax_id` string, nullable: Customer's tax ID.
    - `twitter` string, nullable: Twitter handle.
    - `updated_at` string: Last update timestamp in UTC.
    - `version` integer: Auto-incrementing object version number.
    - `website` string, nullable: Website URL.
    - `year_to_date` number, double: Customer's spending this year.

---

[API](https://skmtc.dev/lightspeedhq/apis/lightspeedhq.md) - [All operations](https://skmtc.dev/lightspeedhq/apis/lightspeedhq/llms.txt) - [OpenAPI document](https://skmtc.dev/lightspeedhq/apis/lightspeedhq/revisions/463fb1f94056?raw)