v31

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-215985245.8 KB

mailbox

Fulfill a Lockbox Request

Notifies Chariot that a new PO box has been provisioned by the lockbox provider.

The request_id is a one-time unique value generated by Chariot for each PO box request.

See the Provisioning guide for the full provisioning flow.

post/v1/lockboxes/fulfill_request

Request body

request_idstring required

The unique request identifier originally provided by Chariot when the PO box was requested.

location_idstring required

The identifier of the newly provisioned PO box.

Example request

{
  "request_id": "123456789",
  "location_id": "po_9876",
  "address": {
    "city": "New York",
    "country": "US",
    "line1": "123 Main St.",
    "postal_code": "12345",
    "state": "NY"
  }
}

Response

Indicates the PO box has been successfully provisioned.