Skip to content
Colleqtive Developer
Get started
API Reference
Locations

Retrieves products at a specific store location.

GET/api/v2/public/stores/{store_number}/locations/{location_code}/products

Retrieves products at a specific store location.

Path ParametersExpand Collapse
store_number: string
location_code: string
Query ParametersExpand Collapse
customer_order_number: optional string

Optional customer order number filter.

customer_order_shipment_number: optional string

Optional customer order shipment number filter.

page_size: optional number

The number of items per page.

formatint32
page_start: optional number

The starting page index for pagination.

formatint32
search_text: optional string

Optional text to search products by name or barcode.

Header ParametersExpand Collapse
"Accept-Language": optional string
ReturnsExpand Collapse
list: array of object { product_number, barcode, customer_order_line_number, 6 more }

Collection of items for the current page.

product_number: string

Product number.

barcode: optional string

Product barcode.

customer_order_line_number: optional number

Customer order line number.

formatint64
customer_order_number: optional string

Associated customer order number.

customer_order_shipment_line_number: optional number

Customer order shipment line number.

formatint32
customer_order_shipment_number: optional string

Customer order shipment number.

image_url: optional string

URL of the product image.

product_description: optional string

Product description.

quantity: optional number

Current stock quantity at this location.

formatdouble
list_body: optional map[unknown]

Additional body-level metadata for the list.

list_filters: optional map[array of string]

Active filter criteria applied to the result set, keyed by field name.

next_page: optional number

Next page number, or null when on the last page.

formatint32
page_size: optional number

Maximum number of items returned per page.

formatint64
page_start: optional number

Current page number (1-based).

formatint64
previous_page: optional number

Previous page number, or null when on the first page.

formatint64
project_last_modified_date: optional string

Last modified date/time of the project.

scroll_id: optional string

Opaque scroll identifier for deep-pagination scenarios.

server_time: optional string

Server UTC date/time when the response was generated.

sort_column: optional string

Column name the results are sorted by.

sort_order: optional string

Sort direction.

task_last_modified_date: optional string

Last modified date/time of the task.

total_count: optional number

Total number of records matching the query across all pages.

formatint64

Retrieves products at a specific store location.

curl https://api.colleqtive.net/api/v2/public/stores/$STORE_NUMBER/locations/$LOCATION_CODE/products \
    -H "Authorization: $COLLEQTIVE_BEARER_TOKEN"
{
  "list": [
    {
      "product_number": "PRD-001",
      "barcode": "8710400000123",
      "customer_order_line_number": 1,
      "customer_order_number": "CO-2025-001",
      "customer_order_shipment_line_number": 1,
      "customer_order_shipment_number": "SH-2025-001",
      "image_url": "https://cdn.example.com/products/prd-001.jpg",
      "product_description": "Organic Milk 1L",
      "quantity": 15
    }
  ],
  "list_body": {
    "foo": "bar"
  },
  "list_filters": {
    "foo": [
      "string"
    ]
  },
  "next_page": 4,
  "page_size": 25,
  "page_start": 3,
  "previous_page": 2,
  "project_last_modified_date": "2025-06-10T08:00:00Z",
  "scroll_id": "DXF1ZXJ5QW5kRmV0Y2g",
  "server_time": "2025-06-15T14:30:00Z",
  "sort_column": "name",
  "sort_order": "asc",
  "task_last_modified_date": "2025-06-12T10:15:00Z",
  "total_count": 142
}
Returns Examples
{
  "list": [
    {
      "product_number": "PRD-001",
      "barcode": "8710400000123",
      "customer_order_line_number": 1,
      "customer_order_number": "CO-2025-001",
      "customer_order_shipment_line_number": 1,
      "customer_order_shipment_number": "SH-2025-001",
      "image_url": "https://cdn.example.com/products/prd-001.jpg",
      "product_description": "Organic Milk 1L",
      "quantity": 15
    }
  ],
  "list_body": {
    "foo": "bar"
  },
  "list_filters": {
    "foo": [
      "string"
    ]
  },
  "next_page": 4,
  "page_size": 25,
  "page_start": 3,
  "previous_page": 2,
  "project_last_modified_date": "2025-06-10T08:00:00Z",
  "scroll_id": "DXF1ZXJ5QW5kRmV0Y2g",
  "server_time": "2025-06-15T14:30:00Z",
  "sort_column": "name",
  "sort_order": "asc",
  "task_last_modified_date": "2025-06-12T10:15:00Z",
  "total_count": 142
}