---
title: "List Checkbooks"
method: GET
path: "/checkbooks"
---

# List Checkbooks

`GET /checkbooks`

## Request

- Base URL: `https://api.increase.com`
- URL: `https://api.increase.com/checkbooks`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/increase/apis/increase-api-2/docs/checkbooks/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `cursor` string: Return the page of entries after this one.
- `limit` integer: Limit the size of the list that is returned. The default (and maximum) is 100 objects.
- `account_number_id` string: Filter Checkbooks to those attached to the specified Account Number.
- `status.in` string[]: Filter Checkbooks for those with the specified status or statuses. For GET requests, this should be encoded as a comma-delimited string, such as `?in=one,two,three`.
- `idempotency_key` string: Filter records to the one with the specified `idempotency_key` you chose for that object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).

## Response `200`

Checkbook List

- CheckbookList: A list of Checkbook objects.
  - `data` Checkbook[], required: The contents of the list.
    - `account_number_id` string, required: The identifier of the Account Number the Checkbook is attached to.
    - `created_at` string, date-time, required: The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Checkbook was created.
    - `id` string, required: The Checkbook's identifier.
    - `idempotency_key` string, nullable, required: The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
    - `mailing_address` object, required: The destination address that the Checkbook will be mailed to.
      - `city` string, required: The city of the destination address.
      - `line1` string, required: The first line of the destination address.
      - `line2` string, nullable, required: The second line of the destination address.
      - `name` string, required: The recipient at the destination address.
      - `postal_code` string, required: The postal code of the destination address.
      - `state` string, required: The state of the destination address.
    - `payer` object[], required: The payer information printed on the top-left corner of each check.
      - `contents` string, required: The contents of the line.
    - `return_address` object, required: The address the Checkbook will return to if there is a delivery issue.
      - `city` string, required: The city of the return address.
      - `line1` string, required: The first line of the return address.
      - `line2` string, nullable, required: The second line of the return address.
      - `name` string, required: The recipient at the return address.
      - `postal_code` string, required: The postal code of the return address.
      - `state` string, required: The state of the return address.
    - `status` 'pending_submission' | 'pending_mailing' | 'mailed' | 'stopped', required: The lifecycle status of the Checkbook.
    - `style` 'three_ring_binder' | 'folder', required: The physical format of the Checkbook.
    - `tracking_updates` object[], required: Tracking updates relating to the Checkbook's delivery.
      - `category` 'in_transit' | 'processed_for_delivery' | 'delivered' | 'delivery_issue' | 'returning_to_sender' | 'returned_to_sender', required: The type of tracking event.
      - `country` string, required: The ISO 3166-1 alpha-2 country code for the country where the event took place.
      - `created_at` string, date-time, required: The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the tracking event took place.
      - `postal_code` string, required: The postal code where the event took place.
    - `type` 'checkbook', required: A constant representing the object's type. For this resource it will always be `checkbook`.
  - `next_cursor` string, nullable, required: A pointer to a place in the list. Pass this as the `cursor` parameter to retrieve the next page of results. If there are no more results, the value will be `null`.

## Other responses

- `4XX`: Error
- `5XX`: Error

## Changes

- **2026-11-07** `1fd30bec4150`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/increase/apis/increase-api-2/changes/checkbooks/get.md)

---

[API](https://skmtc.dev/increase/apis/increase-api-2.md) - [All operations](https://skmtc.dev/increase/apis/increase-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/increase/apis/increase-api-2/revisions/1fd30bec4150?raw)