> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# GET /checkout-domains

**List checkout domains**

Returns a paginated list of checkout domains submitted for your account. Use the query parameters to page through results.

**Required permissions:** `checkout_domain.read`

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | array | optional | Return only the IDs specified. Use a comma-separated list to get multiple entities. |
| `after` | string | optional | Return entities after the specified Paddle ID when working with paginated endpoints. Used in the `meta.pagination.next` URL in responses for list operations. |
| `per_page` | integer | optional | Set how many entities are returned per page. Paddle returns the maximum number of results if a number greater than the maximum is requested. Check `meta.pagination.per_page` in the response to see how many were returned.

Default: `50`; Maximum: `200`. (Max: 200; default: `50`) |
| `domain` | string | optional | Filter results to include the specified fully qualified domain name (FQDN), its ancestors, and any of its subdomains. For example, if you provide `app.example.com`, the results include `app.example.com`, `example.com` and any subdomains such as `cool.app.example.com`. |
| `order_by` | string | optional | Order returned entities by the specified field and direction (`[ASC]` or `[DESC]`). For example, `?order_by=id[ASC]`.

Valid fields for ordering: `id`, `created_at`, and `updated_at`. (default: `"id[DESC]"`) |
| `status` | array | optional | Return entities that match the specified status. Use a comma-separated list to specify multiple status values. |

Values for `status`:

- `pending_review` — Return the checkout domains that are newly added and pending review.
- `approved` — Return the checkout domains that have been approved and can be used for checkouts.
- `rejected` — Return the checkout domains that have been rejected and cannot be used for checkouts.
- `in_review` — Return the checkout domains that are currently under review by Paddle.

## Response (200)

- `data`: array (required)
- `meta`: object (required) — Information about this response.
  - `request_id`: string (required) — Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.
  - `pagination`: object (required) — Keys used for working with paginated results.
    - `per_page`: integer (required) — Number of entities per page for this response. May differ from the number requested if the requested number is greater than the maximum.
    - `next`: string (uri) (required) — URL containing the query parameters of the original request, along with the `after` parameter that marks the starting point of the next page. Always returned, even if `has_more` is `false`.
    - `has_more`: boolean (required) — Whether this response has another page.
    - `estimated_total`: integer — Estimated number of entities for this response.

For datasets with 100,000 or fewer matches, returns the exact count. For datasets with more than 100,000 matches, returns `100001` to indicate that more than 100,000 entities match. Returns `-1` when counting is skipped or couldn't be calculated.

Use `has_more` and `next` to page through all results rather than relying on `estimated_total` for an exact count.

### Response example

```json
{
  "data": [
    {
      "id": "chedom_01j2abc3def4ghi5jkl6mno7pq",
      "domain": "app.example.com",
      "status": "approved",
      "payment_method_verification": {
        "apple_pay": {
          "status": "verified"
        }
      },
      "created_at": "2026-03-04T12:00:00.000Z",
      "updated_at": "2026-03-04T14:30:00.000Z"
    },
    {
      "id": "chedom_01k9zyx8wvu7tsp5qra4lkj2mn",
      "domain": "store.example.net",
      "status": "pending_review",
      "payment_method_verification": {
        "apple_pay": {
          "status": "unverified"
        }
      },
      "created_at": "2026-04-10T15:20:00.000Z",
      "updated_at": "2026-04-10T16:45:00.000Z"
    }
  ],
  "meta": {
    "request_id": "e7f2d619-3c84-4a5e-9f10-2b48c7d0e3f1",
    "pagination": {
      "per_page": 50,
      "next": "https://api.paddle.com/checkout-domains?after=chedom_01j2abc3def4ghi5jkl6mno7pq&per_page=50",
      "has_more": false,
      "estimated_total": 2
    }
  }
}
```