Onegripper Inventory API

Version 1

Read-only access to current Onegripper inventory directly from Shopify.

Base URL

https://inventory.onegripper.com/api/v1

Authentication

Send your API key using the X-API-Key HTTP header.

X-API-Key: YOUR_API_KEY

Warehouses

GET /warehouses

Response:

{
  "warehouses": ["sweden"]
}

Single SKU

GET /inventory/OGSC01-V2-BL?warehouse=sweden

Response:

{
  "sku": "OGSC01-V2-BL",
  "available": 0
}

Multiple SKUs

GET /inventory?skus=OGSC01-V2-BL,OGSC02-BLGNGN&warehouse=sweden

Response:

{
  "inventory": [
    {
      "sku": "OGSC01-V2-BL",
      "available": 0
    },
    {
      "sku": "OGSC02-BLGNGN",
      "available": 60
    }
  ]
}

Warehouse

The default warehouse is sweden. If the warehouse parameter is omitted, the Swedish warehouse is used automatically.

Stock quantities

The available field represents current available Shopify inventory for the selected Onegripper warehouse. Negative Shopify quantities are returned as 0.

Limits

A maximum of 100 SKUs can be requested in one batch request. The default API rate limit is 120 requests per minute per API client.

HTTP status codes

200  Success
400  Invalid request
401  Invalid or missing API key
404  SKU not found
429  Rate limit exceeded
502  Shopify inventory could not be retrieved
503  Warehouse or API temporarily unavailable