---
title: "List Lockboxes"
method: GET
path: "/lockboxes"
---

# List Lockboxes

`GET /lockboxes`

## 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_id` string — Filter Lockboxes to those associated with the provided Account.
- `created_at.after` string, date-time — Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.before` string, date-time — Return results before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_after` string, date-time — Return results on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_before` string, date-time — Return results on or before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `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`

Lockbox List

- LockboxList — A list of Lockbox objects.
  - `data` Lockbox[], required — The contents of the list.
    - `account_id` string, required — The identifier for the Account checks sent to this lockbox will be deposited into.
    - `address` object, required — The mailing address for the Lockbox.
      - `city` string, required — The city of the address.
      - `line1` string, required — The first line of the address.
      - `line2` string, required — The second line of the address.
      - `postal_code` string, required — The postal code of the address.
      - `recipient` string, nullable, required — The recipient line of the address. This will include the recipient name you provide when creating the address, as well as an ATTN suffix to help route the mail to your lockbox. Mail senders must include this ATTN line to receive mail at this Lockbox.
      - `state` string, required — The two-letter United States Postal Service (USPS) abbreviation for the state of the address.
    - `check_deposit_behavior` 'enabled' | 'disabled' | 'pend_for_processing', required — Indicates if checks mailed to this lockbox will be deposited.
    - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Lockbox was created.
    - `description` string, nullable, required — The description you choose for the Lockbox.
    - `id` string, required — The Lockbox 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).
    - `recipient_name` string, nullable, required — The recipient name you choose for the Lockbox.
    - `type` 'lockbox', required — A constant representing the object's type. For this resource it will always be `lockbox`.
  - `next_cursor` string, nullable, required — A pointer to a place in the list.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.dev/increase/apis/increase-api.md) · [All operations](https://skmtc.dev/increase/apis/increase-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/increase/increase-api/revisions/07202bc3c027/schema)