---
title: "List Lockboxes"
method: GET
path: "/v1/lockboxes"
tags: ["lockboxes"]
---

# List Lockboxes

`GET /v1/lockboxes`

List lockboxes for your account.

A Lockbox represents a vendor that receives physical mail and scans checks on Chariot's behalf.
Lockboxes are the source of Mail Items, which in turn produce Donations and Deposits.
Lockboxes are provisioned and managed by Chariot.

## Query parameters

- `limit` integer
- `page_token` string

## Response `200`

The response for Lockboxes.list

- object
  - `results` Lockbox[]
    - `id` string, required — The unique identifier for the lockbox.
    - `address` PostalAddress — A postal address is a mailing address where physical mail can be received. Postal addresses can be used to receive paper checks.
      - `city` string, required — City, district, suburb, town, or village.
      - `country` string, required — Two-letter country code (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
      - `line1` string, required — Address line 1 (e.g. street, PO Box, or company name)
      - `line2` string — Address line 2 (e.g. apartment, suite, unit, or building)
      - `postal_code` string, required — ZIP or postal code
      - `state` string, required — State, county, province, or region
    - `created_at` string, date-time, required — The date and time when the lockbox was created.
    - `updated_at` string, date-time — The date and time when the lockbox was last updated.
  - `next_page_token` string — A cursor token to use to retrieve the next page of results by making another API call to the same endpoint with the same parameters (only changing the pageToken). If specified, then more results exist on the server that were not returned, otherwise no more results exist on the server.

## Other responses

- `400` — The request is invalid or contains invalid parameters
- `401` — Unauthorized. The request is missing the security (OAuth2 Bearer token) requirements and the server is unable to verify the identify of the caller.
- `403` — Access denied
- `500` — Internal Server Error

---

[API](https://skmtc.net/chariot-giving/apis/specs.md) · [All operations](https://skmtc.net/chariot-giving/apis/specs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chariot-giving/specs/revisions/8446023e02fb/schema)