Markets

Nabis organizes its operations into markets. Records like retailers, warehouses and Nabis days off belong to a market, and include its ID as marketId in API responses.

Use Get Many Markets to list every market and its ID:

curl https://customer-api.nabis.pro/v3/markets \
  -H 'x-nabis-access-token: <access-token>'

[
  {
    "id": "6f7eaf7a-805d-4b38-87d5-21e2d33074bc",
    "name": "CA",
    "state": "CA"
  },
  {
    "id": "26853555-0aae-4203-81f5-4b80fe2216b5",
    "name": "NY",
    "state": "NY"
  }
]

Each market includes the US state it operates in. Use a market's id, not its name or state, to identify it: market IDs don't change, so you can look them up once and reuse them.

Filtering by market

Endpoints that return records from several markets accept an optional marketId query parameter. Without it, records from every market are returned.

For example, to only return retailers in the CA market:

curl "https://customer-api.nabis.pro/v3/retailers?page=0&limit=100&marketId=6f7eaf7a-805d-4b38-87d5-21e2d33074bc" \
  -H 'x-nabis-access-token: <access-token>'