# API reference

> Every endpoint of the ShopAssist merchant API v1, generated from the OpenAPI document.

Source: https://shopassist.coec.dk/docs/api/reference · Updated 2026-11-03

Base URL `https://api.shopassist.coec.dk`. Authenticate with `Authorization: Bearer sa_live_…` (see [authentication](/docs/api/authentication)). Each page shows the required scope and the rate limit.

## Stores [#stores]

* [List Stores](/docs/api/reference/stores/list-stores) — `GET /v1/stores`
* [Get Store](/docs/api/reference/stores/get-store) — `GET /v1/stores/{store_id}`

## Conversations [#conversations]

* [List Conversations](/docs/api/reference/conversations/list-conversations) — `GET /v1/stores/{store_id}/conversations`
* [Delete Conversation](/docs/api/reference/conversations/delete-conversation) — `DELETE /v1/stores/{store_id}/conversations/{conversation_id}`
* [Get Conversation](/docs/api/reference/conversations/get-conversation) — `GET /v1/stores/{store_id}/conversations/{conversation_id}`
* [List Csat](/docs/api/reference/conversations/list-csat) — `GET /v1/stores/{store_id}/csat`
* [List Handoffs](/docs/api/reference/conversations/list-handoffs) — `GET /v1/stores/{store_id}/handoffs`

## Leads and back in stock [#leads-and-back-in-stock]

* [List Back In Stock](/docs/api/reference/engagement/list-back-in-stock) — `GET /v1/stores/{store_id}/back-in-stock-subscriptions`
* [List Leads](/docs/api/reference/engagement/list-leads) — `GET /v1/stores/{store_id}/leads`
* [Delete Lead](/docs/api/reference/engagement/delete-lead) — `DELETE /v1/stores/{store_id}/leads/{lead_id}`
* [Get Lead](/docs/api/reference/engagement/get-lead) — `GET /v1/stores/{store_id}/leads/{lead_id}`

## Analytics [#analytics]

* [Get Overview](/docs/api/reference/analytics/get-overview) — `GET /v1/stores/{store_id}/analytics/overview`
* [Get Timeseries](/docs/api/reference/analytics/get-timeseries) — `GET /v1/stores/{store_id}/analytics/timeseries`

## Knowledge base [#knowledge-base]

* [List Documents](/docs/api/reference/knowledge/list-documents) — `GET /v1/stores/{store_id}/knowledge/documents`
* [Delete Faq](/docs/api/reference/knowledge/delete-faq) — `DELETE /v1/stores/{store_id}/knowledge/faqs/{external_ref}`
* [Upsert Faq](/docs/api/reference/knowledge/upsert-faq) — `PUT /v1/stores/{store_id}/knowledge/faqs/{external_ref}`

## Catalog Push API [#catalog-push-api]

* [Push Categories](/docs/api/reference/catalog/push-categories) — `POST /v1/stores/{store_id}/catalog/categories:batch`
* [Push Inventory](/docs/api/reference/catalog/push-inventory) — `POST /v1/stores/{store_id}/catalog/inventory:batch`
* [Push Locations](/docs/api/reference/catalog/push-locations) — `POST /v1/stores/{store_id}/catalog/locations:batch`
* [Push Pages](/docs/api/reference/catalog/push-pages) — `POST /v1/stores/{store_id}/catalog/pages:batch`
* [Push Products](/docs/api/reference/catalog/push-products) — `POST /v1/stores/{store_id}/catalog/products:batch`
* [Delete Products](/docs/api/reference/catalog/delete-products) — `POST /v1/stores/{store_id}/catalog/products:delete`
* [Report Orders](/docs/api/reference/catalog/report-orders) — `POST /v1/stores/{store_id}/orders:report`

## Privacy requests [#privacy-requests]

* [Create Privacy Request](/docs/api/reference/privacy/create-privacy-request) — `POST /v1/stores/{store_id}/privacy-requests`
* [Get Privacy Request](/docs/api/reference/privacy/get-privacy-request) — `GET /v1/stores/{store_id}/privacy-requests/{request_id}`

## Event log [#event-log]

* [List Events](/docs/api/reference/events/list-events) — `GET /v1/events`
* [Get Event](/docs/api/reference/events/get-event) — `GET /v1/events/{event_id}`

## AI content verification [#ai-content-verification]

* [Verify Ai Content](/docs/api/reference/ai-content/verify-ai-content) — `POST /v1/ai-content/verify`