# Public Suppliers List

Cursor-paginated list of suppliers.

Endpoint: GET /suppliers
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 supplier's supplier_id when present

  - `data.supplier_id` (string | null)

  - `data.name` (string, required)

  - `data.emails` (array)

  - `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 supplier 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)

