> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beachdepository.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Inbound Shipments

> List inbound shipments

Returns a paginated list of inbound shipments for the organization.

**Permission:** `inbound_shipments:read`

## Query parameters

<ParamField query="page" type="number" default="1">
  1-indexed page number.
</ParamField>

<ParamField query="limit" type="number" default="25">
  Number of results per page (max 100).
</ParamField>

<ParamField query="status" type="string">
  Filter by shipment status. One of `pending`, `in_transit`, `received`, `inspecting`, `pending_approval`, `accepted`, `partially_accepted`, `rejected`.
</ParamField>

<ParamField query="fboAccountId" type="string">
  Filter by FBO account ID
</ParamField>

## Response

```json theme={null}
{
  "data": [
    {
      "id": "ship_in_abc123",
      "fboAccountId": "fbo_abc123",
      "organizationId": "org_abc123",
      "status": "received",
      "shipmentNotes": "10x 1oz Gold Eagles",
      "trackingNumber": "1Z999AA10123456784",
      "carrier": "UPS",
      "receivedAt": 1744277400000,
      "createdAt": "2025-04-05T16:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "hasMore": false
  }
}
```

<Note>
  `createdAt` is an ISO-8601 string; other timestamps (e.g. `receivedAt`, `approvedAt`) are Unix epoch milliseconds.
</Note>