Inventory locations

Inventory location endpoints provide the stable UUIDs required by item, variation, purchase-order, and sales-order requests. They are read-only and follow the API key user's current inventory permissions.

The location object

Field	Type	Description
`id`	string	Unique inventory-location UUID.
`object`	string	Always `location`.
`name`	string	Full location name.
`short_name`	string	Short location label configured in SalesBinder.

The response includes only the location fields listed above.

List inventory locations

GET/api/v3/locations

Required scope: items:read

Returns active inventory locations belonging to the current account, ordered by name. Users restricted to one inventory location receive only their assigned location.

Query parameters

Parameter	Type	Required	Description
`page`	integer	No	Page number. Defaults to `1`.
`limit`	integer	No	Records per page from `1` to `100`. Defaults to `20`.

curl "https://yourbusiness.salesbinder.com/api/v3/locations?page=1&limit=20" \
  --header "Authorization: Bearer YOUR_API_KEY"

{
  "object": "list",
  "url": "/api/v3/locations",
  "has_more": false,
  "data": [
    {
      "id": "828e6967-55f6-4b92-81b0-af53979211f8",
      "object": "location",
      "name": "Main Warehouse",
      "short_name": "Main"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total_pages": 1,
    "total_records": 1
  }
}

The endpoint uses the standard page-based pagination format. Inactive locations and locations belonging to another account are never returned.

The zone object

Field	Type	Description
`id`	string	Unique zone UUID.
`object`	string	Always `zone`.
`location_id`	string	UUID of the zone's parent inventory location.
`name`	string	Full zone name.
`short_name`	string	Short zone label configured in SalesBinder.
`description`	string or null	Optional zone description.

List zones at a location

GET/api/v3/locations/{location_id}/zones

Required scope: items:read

Returns zones belonging to one active, accessible inventory location, ordered by name. The endpoint accepts the standard page and limit query parameters.

curl "https://yourbusiness.salesbinder.com/api/v3/locations/828e6967-55f6-4b92-81b0-af53979211f8/zones?page=1&limit=20" \
  --header "Authorization: Bearer YOUR_API_KEY"

{
  "object": "list",
  "url": "/api/v3/locations/828e6967-55f6-4b92-81b0-af53979211f8/zones",
  "has_more": false,
  "data": [
    {
      "id": "63325b59-c6c3-4586-94ca-ce8ba2a47d85",
      "object": "zone",
      "location_id": "828e6967-55f6-4b92-81b0-af53979211f8",
      "name": "Aisle A",
      "short_name": "A",
      "description": "Primary picking aisle"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total_pages": 1,
    "total_records": 1
  }
}

A location without zones returns an empty list. An inactive location, a location in another account, or a location outside the user's assigned-location boundary returns 404 resource_missing.