List inbound shipments

GET /api/v1/inbound-shipments read:inventory

Lists your inbound shipments, newest first by created_at. That includes any package that arrived unannounced and was logged against your account at the door (source "warehouse"). Poll ?status=EXPECTED to see what we are still waiting for, or consume inbound_shipment.received from your activity log instead of polling. Paged like every other list: read pagination.has_more and pass pagination.next_offset back as ?offset.

Try it GET /api/v1/inbound-shipments?limit=10

These inputs are shared across all docs pages, so an id entered here carries over.

response

Not run yet. Press Run to make a live call against https://service.rip.fun (through this demo's server-side proxy; the API key never reaches the browser).

curl (tracks the inputs above)
curl -X GET 'https://service.rip.fun/api/v1/inbound-shipments?limit=10' \
  -H 'X-API-Key: rip_…'

Request fields

FieldTypeRequiredDescription
statusquery stringEXPECTED | RECEIVED | CANCELLED — matched exactly; an unrecognized value returns 400
tracking_numberquery stringFind a package by its tracking number, matched the same forgiving way as on create
sitequery stringOnly packages addressed to this site code — any site, including one that has since stopped receiving, so older packages stay findable. An unknown code returns 400
limit / offsetquery intlimit 1..100 default 50; offset 0..10_000 default 0. Non-integer values are a 400 (invalid_pagination). The response carries a pagination object { limit, offset, has_more, next_offset } beside the array

Response fields (data)

FieldDescription
inbound_shipments[]Same row shape as POST /inbound-shipments

Errors

StatusCodeWhen
400invalid statusstatus is not one of the accepted values

See Errors for the response envelope and the full code list.