Skip to main content
The Beach Depository API provides programmatic access to manage organizations, FBO accounts, inventory, shipments, outbound requests, transfers, shipping labels, and statements. Base URL:
All requests must include a valid API key. See the Authentication page for details. To test your integration against isolated data, use a sandbox key — same API, no effect on live data.

​
Resources

Organization

Manage your organization profile and members

FBO Accounts

Create and manage FBO accounts

Inventory

View inventory items and their status

Inbound Shipments

Track shipments coming into the vault

Outbound Requests

Request inventory to leave the vault

Outbound Shipments

Track shipments leaving the vault

Transfers

Move inventory between FBO accounts

Webhooks

Subscribe to real-time event notifications

Statements

Access account statements

Labels

Quote shipping label rates for inbound shipments

​
Idempotency

POST create endpoints (FBO accounts, FBO account aliases, inbound shipments, outbound requests, transfers, webhooks) accept an optional Idempotency-Key header (any unique string up to 255 characters). Retrying a request with the same key within 24 hours returns the original response instead of creating a duplicate; replayed responses include an Idempotency-Replayed: true header. Reusing a key while the first request is still in progress returns 409; reusing it on a different endpoint returns 422.

​
Errors

The API uses standard HTTP status codes to indicate success or failure: See the Errors page for the full error response format.