Retrieve inventory count
Retrieves the current calculated stock count for a given CatalogObject at a given set of Locations.
Responses are paginated and unsorted. For more sophisticated queries, use a batch endpoint.
| Name | Description |
|---|---|
catalog_
Required
|
ID of the CatalogObject to retrieve. |
| Name | Description |
|---|---|
location_
|
The Location IDs to look up as a comma-separated list. An empty list queries all locations. |
cursor
|
A pagination cursor returned by a previous call to this endpoint. Provide this to retrieve the next set of results for the original query. See the Pagination guide for more information. |
Response Fields
| Name | Description |
|---|---|
errors
|
Any errors that occurred during the request. |
counts
|
The current calculated inventory counts for the requested object and locations. |
cursor
|
The pagination cursor to be used in a subsequent request. If unset, this is the final response. See the Pagination guide for more information. |
Examples
- cURL
- Ruby
- Python
- C#
- Java
- PHP
- Node.js
curl https://connect.squareup.com/v2/inventory/catalog_object_id0?location_ids=C6W5YS5QM06F5 \
-H 'Square-Version: 2021-03-17' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json'{
"errors": [],
"counts": [
{
"catalog_object_id": "W62UWFY35CWMYGVWK6TWJDNI",
"catalog_object_type": "ITEM_VARIATION",
"state": "IN_STOCK",
"location_id": "C6W5YS5QM06F5",
"quantity": "22",
"calculated_at": "2016-11-16T22:28:01.223Z"
}
]
}