Retrieves a list of inventory levels. You must include inventory_item_ids, location_ids, or both as filter parameters. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.

https://shopify.com/admin/api/2020-10/inventory_levels.json

https://shopify.dev/docs/admin-api/rest/reference/inventory/inventorylevel#index-2020-10

Access Token Required: API Key

Query Params

inventory_item_idsstring

A comma-separated list of inventory item IDs. (maximum: 50)

location_idsstring

A comma-separated list of location IDs. To find the ID of a location, use the Location resource. (maximum: 50)

limitstring

The maximum number of results to show. (default: 50, maximum: 250)

updated_at_minstring

Show inventory levels updated at or after date (format: 2019-03-19T01:21:44-04:00).

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'https://shopify.com/admin/api/2020-10/inventory_levels.json' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

GET