Fetch inventory locations
Through access to the data of a merchant’s locations, you can retrieve a list of all location UUIDs. These are used when working with inventory balances and stock management.
By default, an organization has four locations: STORE
, SOLD
, SUPPLIER
and BIN
. They each represent a conceptual location with an inventory level. The most commonly used location is STORE
. This represents the stock level in the customer-facing store or warehouse. However, you can use any of the available locations to read inventory stats for other types of locations.
- Authorization setup with the correct scope, and a valid authorization token. See How inventories work.
- Required access right:
READ:PRODUCT
Use this request to retrieve all inventory location UUIDs for the organization the client is signed in as.
1GET /organizations/self/locations
Example: This example retrieves the location UUIDs for the organization associated with the authorization token. The token is passed in the request header and is of type Authorization: Bearer eyJraWQiOiIxNjM3MTg1Mjg0Nz...
in this example.
Request
1GET /organizations/self/locations2Host: inventory.izettle.com3Authorization: Bearer eyJraWQiOiIxNjM3MTg1Mjg0Nz...
Response
1[2{3"uuid": "fd4a39a0-e2ef-11e6-ba64-85247ae2a737",4"type": "STORE",5"name": "STORE",6"description": "System generated location ",7"default": true8},9{10"uuid": "fd4ad5e0-e2ef-11e6-a2b0-e5c90fd52c77",11"type": "BIN",12"name": "BIN",13"description": "System generated location ",14"default": false15},16{17"uuid": "fd4a87c0-e2ef-11e6-bfe3-78ba29c12242",18"type": "SOLD",19"name": "SOLD",20"description": "System generated location ",21"default": false22},23{24"uuid": "fd40ead0-e2ef-11e6-8c44-45d2bd8a4fd8",25"type": "SUPPLIER",26"name": "SUPPLIER",27"description": "System generated location ",28"default": false29}30]
Ensure location UUIDs are saved so they are available for access by the client system. They will be used in most other calls when managing inventory balances.