---
title: "List customers, newest first; q searches name, email and phone. Page with before=<next_before>."
method: GET
path: "/customers"
tags: ["customers"]
---

# List customers, newest first; q searches name, email and phone. Page with before=<next_before>.

`GET /customers`

## Request

- Base URL: `https://daybag.io/api/v1`
- URL: `https://daybag.io/api/v1/customers`
- Auth: HTTP bearer

## Query parameters

- `q` string
- `limit` integer
- `before` string, uuid: A customer's id: the page continues with those added before them (pass next_before)

## Response `200`

Success

- object
  - `data` object[], required
    - `id` string, required
    - `org_id` string, required
    - `email` string, required: Lowercase; unique within the org
    - `name` string, required
    - `phone` string, required
    - `notes` string, required
    - `metadata` unknown, required
    - `created_at` string, required: ISO 8601 timestamp (UTC)
  - `next_before` string, nullable, required: Pass as before= for the next page; null after the last

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/daybag/apis/daybooked-io-api.md) · [All operations](https://skmtc.dev/daybag/apis/daybooked-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/daybag/apis/daybooked-io-api/revisions/1f576dead370?raw)