List Shiptheory Warehouse Mappings
GET/api/shiptheory/:integration_instance/warehouses
Returns every SKU warehouse zipped with its Shiptheory mapping on this instance. A null mapping (enabled=false, mapping_id=null) means the warehouse is not routed to Shiptheory. Each row carries sender_address — the warehouse's own address exactly as it is sent to Shiptheory as the shipment sender, or null when the address is incomplete (Shiptheory then uses the account's default Shipping Location) — plus sender_address_missing, the address fields still needed (address line 1, city, postcode, country). Each row also carries a cross-link to the SKU warehouse, the warehouse_type, and routable — true only for your own (direct) or 3PL warehouses, the only ones that can ship through Shiptheory. There is no provider-side location catalog to sync — the list reflects your SKU warehouses.
integrations:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Path parameter:
- integration_instance: the numeric id of the Shiptheory integration instance.
Authentication: requires a Bearer token.
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.