# Public Customers List

Cursor-paginated list of customers.

Endpoint: GET /customers
Version: 1.79.2

## Query parameters:

  - `cursor` (string | null)
    Opaque cursor from prior page

  - `modified_since` (string | null)
    ISO-8601 lower bound on `updated_at`. Applied only on the first page; the cursor is a strict super-set thereafter.

  - `limit` (integer | null)

## Header parameters:

  - `authorization` (string | null)
    Bearer <mrc_live_…> API key

## Response 200:

  - `200` (unknown)
    Successful Response

## Response 200 fields (application/json):

  - `data` (array, required)

  - `data.id` (string | null)
    Public id; equals the customer's customer_id when present

  - `data.customer_id` (string | null)

  - `data.name` (string, required)

  - `data.vat_id` (string | null)

  - `data.emails` (array)

  - `data.address` (object)
    Postal address shared across customers and suppliers.
    Example: {"city":"Düsseldorf","country":"DE","is_default":true,"kind":"billing","postal_code":"40210","region":"NRW","street":"Industriestraße","street_number":"12"}

  - `data.address.kind` (string | null)
    Address type, e.g. billing | shipping | hq

  - `data.address.street` (string | null)

  - `data.address.street_number` (string | null)
    House / building number kept separate from street for ERPs that store them apart

  - `data.address.postal_code` (string | null)

  - `data.address.city` (string | null)

  - `data.address.region` (string | null)

  - `data.address.country` (string | null)
    ISO 3166-1 alpha-2 country code

  - `data.address.is_default` (boolean | null)

  - `data.custom_fields` (object | null)
    Organisation-defined custom fields, keyed by the field's display **label** (v1.9.0; previously keyed by the internal column UUID). Columns with no active definition are omitted; null when the customer carries none. On duplicate labels the field defined first (by display order, then creation time) wins.

  - `data.created_at` (string, required)

  - `data.updated_at` (string, required)

  - `next_cursor` (string | null)

## Response 422:

  - `422` (unknown)
    Validation Error

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)

  - `detail.input` (any)

  - `detail.ctx` (object)