List Products
GET/api/trackstar/integration-instances/:integration_instance/products
List all Trackstar products for an integration instance. Supports search and active-only filtering. Requires Bearer token.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Query parameters:
- search (optional, string): Search by SKU or product name
- active_only (optional, boolean): Return only active products
Requires the integrations.show permission.
Each product carries sku_product_id and sku_product — the SKU.io product it stands for — and link_source: mapped when linked by hand, sku_match when linked because the SKUs are identical, or null when unlinked. A manual mapping replaces the SKU match: once a SKU.io product is mapped to one Trackstar product, another Trackstar product with the same SKU is no longer linked to it.
Additional filters:
- filter[link_status] (optional): mapped, sku_match or unlinked
- filter[sku_product_id] (optional, integer): the Trackstar product mapped to this SKU.io product
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.