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

# Get a customer

`GET /customers/{customerId}`

## Request

- Base URL: `https://api.c1st.com/api`
- URL: `https://api.c1st.com/api/customers/{customerId}`
- Auth: HTTP bearer

## Path parameters

- `customerId` integer, required

## Response `200`

Ok

- CustomerResponse: The representation of a customer response
  - `content` Customer: The representation of a customer.
    - `id` integer: A unique customer ID
    - `storeid` integer: ID for the store for which the customer is associated
    - `createddate` string, nullable
    - `name` string, nullable: The name of the customer.
    - `phone` string, nullable: The phone number of the customer. Should start with country code, like +45. If not, assume +45.
    - `phone_e164` string, nullable: Phone number in E.164 format, might sometimes be the same as "phone" but this field is guaranteed to be in E.164 format
    - `country` string, nullable: The country of the phone number. Must be in format ISO 3166-1 alpha-2.
    - `email` string, nullable: The email of the customer.
    - `barcode` string, nullable: Barcode used for POS customer lookup via barcode scanning.
    - `address` string, nullable: The address of the customer.
    - `city` string, nullable: The city of the customer.
    - `zipcode` string, nullable: The zip code of the customer.
    - `addr_country` string, nullable: The country of the customers address.
    - `lat` number, double, nullable: The latitude of the customer.
    - `lng` number, double, nullable: The longitude of the customer.
    - `birthdate` string, nullable
    - `ean` string, nullable: The EAN number associated with the customer. Must be a valid EAN.
    - `vat` string, nullable: The VAT/CVR number associated with the customer.
    - `customerno` string, nullable: The customer-number associated with the customer.
    - `economic_customernumber` integer, nullable: The e-conomic number of the customer.
    - `balance` number, nullable: The customer's balance
    - `note` string, nullable: A note about the customer.
    - `draft` integer: Whether or not the customer is in draft mode
    - `deleted` integer: Whether or not the customer is deleted
    - `tags` CustomerTag[], nullable: Tags associated with the customer.
      - `title` string, required: The title of the tag
      - `id` integer, nullable: The id of the tag
      - `handle` string, nullable: Unique handle for the produttag. Will be set automatically if not set. This value cannot be changed once set.
      - `color` string, nullable: The color used when displaying the tag in the app
    - `permission_marketing` string, nullable: Timestamp for if when the permission has been granted. `null` if permission hasn't been granted.
    - `updated_at` string, nullable: Timestamp for when the last time the customer is updated.
    - `deleted_at` string, nullable: Timestamp for when the last time the customer is deleted.
    - `loyaltypointsbalance` number, nullable: The customers loyalty point balance
    - `loyalty_member_since` string, nullable: Datetime of when the customer joined the loyalty club. If null, the customer is not part of the loyalty club
    - `loyalty_member_id` number, nullable: Assigned loyalty membership ID when the customer joined the loyalty club. If null, the customer is not part of the loyalty club
    - `shopify_customer_id` number, nullable: The corresponding ShopifyCustomerId if customer is syncronized with Shopify
    - `store` object: Name of partner store that customer is registered in. requires scope 'customerlookup'
      - `id` integer: Store id
      - `title` string: Store title

## Other responses

- `404`: Not found

---

[API](https://skmtc.dev/c1st/apis/customers-1st-api.md) - [All operations](https://skmtc.dev/c1st/apis/customers-1st-api/llms.txt) - [OpenAPI document](https://skmtc.dev/c1st/apis/customers-1st-api/revisions/4250bb326f2a?raw)