List Query Runs

Retrieve a paginated list of query runs with filters for status, platform, topic, and date range.

GET /ai-analytics-service/api/public/v1/query-runs

List Query Runs

cURL

curl --request GET \
  --url https://api.slatehq.ai/ai-analytics-service/api/public/v1/query-runs \
  --header 'Authorization: <authorization>'

200

{
  "content": [
    {
      "queryRun": {
        "id": 123,
        "promptId": 123,
        "topicId": 123,
        "platform": "<string>",
        "status": "<string>",
        "startedAt": "<string>",
        "completedAt": "<string>",
        "errorMessage": "<string>"
      },
      "topicName": "<string>",
      "promptText": "<string>",
      "brandsMentioned": [
        "<string>"
      ]
    }
  ],
  "totalElements": 123,
  "totalPages": 123,
  "number": 123,
  "size": 123
}

Returns a paginated list of query runs in your workspace. Each result includes the associated prompt text, topic name, and brands mentioned in the AI response.

Parameters

Authorization · string · required

Bearer token. Format: Bearer slat_<your-token>.

page · integer

Page number (0-indexed). Default: 0.

size · integer

Number of results per page. Default: 10.

sortBy · string

Field to sort by. Default: startedAt.

sortDir · string

Sort direction. One of: asc, desc. Default: desc.

status · string

Filter by run status (e.g., COMPLETED, FAILED, PENDING).

platform · string[]

Filter by one or more platforms: CHATGPT, PERPLEXITY, GOOGLE_AI_OVERVIEW, GOOGLE_AI_MODE, GEMINI, CLAUDE.

topicId · number

Filter by topic ID.

promptId · number

Filter by prompt ID.

brandId · number

Filter by brand ID.

location · string

Filter by ISO 3166-1 alpha-2 country code (e.g., US).

search · string

Search by prompt text. Case-insensitive partial match.

dateRange · integer

Filter to runs from the last N days.

from · string

Start of date range filter. ISO 8601 format (e.g., 2026-02-01T00:00:00Z).

to · string

End of date range filter. ISO 8601 format. Must be after from if both are provided.

Response

Returns 200 OK with a paginated list of query runs.

content · object[] · required

Array of query run objects with prompt and topic info.

Show query run with context

queryRun · object · required

The query run details.

Show query run object

id · number · required

Query run ID.

promptId · number · required

Associated prompt ID.

topicId · number · required

Associated topic ID.

platform · string · required

AI platform used.

status · string · required

Run status.

startedAt · string · required

Run start time. ISO 8601 format.

completedAt · string

Completion time. null if still running.

errorMessage · string

Error details if failed.

topicName · string · required

Name of the associated topic.

promptText · string · required

The prompt text that was queried.

brandsMentioned · string[]

Brands found in the AI response.

totalElements · integer · required

Total number of query runs matching the filters.

totalPages · integer · required

Total number of pages.

number · integer · required

Current page number (0-indexed).

size · integer · required

Page size.

Example

cURL

curl -s "https://api.slatehq.ai/ai-analytics-service/api/public/v1/query-runs?topicId=42&status=COMPLETED&page=0&size=10" \
  -H "Authorization: Bearer slat_YOUR_TOKEN"

Response

{
  "content": [
    {
      "queryRun": {
        "id": 2048,
        "promptId": 156,
        "topicId": 42,
        "platform": "CHATGPT",
        "status": "COMPLETED",
        "startedAt": "2026-02-11T14:30:00Z",
        "completedAt": "2026-02-11T14:31:15Z",
        "errorMessage": null
      },
      "topicName": "Project Management Tools",
      "promptText": "What is the best project management tool for remote teams?",
      "brandsMentioned": ["Asana", "Monday.com", "Jira"]
    }
  ],
  "totalElements": 85,
  "totalPages": 9,
  "number": 0,
  "size": 10
}

Page numbering starts at 0. Default sort is by startedAt descending (most recent first).

Status codes

Status	Description
200	List returned.
400	Invalid query parameter, location code, or date range (from is after to).
401	Missing or invalid Bearer token. See Authentication.
500	Internal server error.

What’s next

• Get Query Run — Get details for a specific run.
• Get Run Details — View the full AI response and metrics for a run.