List search items

List all search items for a collection in the authenticated business. Returns each item's external_id and whether it is active.

GET/api/external/v2/search/items

Authentication

This endpoint authenticates with an API key via the X-API-Key header (ek_live_... format), instead of the bearer token used in the rest of the reference.

Query parameters

ParameterTypeRequiredDescription
collection_idString (UUID)RequiredUUID of the collection to inspect.

Example request

bash
curl -X GET "https://eclectic-api-537143970188.us-central1.run.app/api/external/v2/search/items?collection_id=35f6f8cc-b550-4278-a2ea-099f3a4e0730" \
  -H "X-API-Key: ek_live_your_api_key_here"

Example response

json
{
  "collection_id": "35f6f8cc-b550-4278-a2ea-099f3a4e0730",
  "count": 2,
  "items": [
    {
      "external_id": "sku-12345",
      "is_active": true
    },
    {
      "external_id": "sku-67890",
      "is_active": false
    }
  ]
}