List Latency Collections

import requests
BASE_URL = "https://api.captain.dev"
API_KEY = "your_api_key"
response = requests.get(
    f"{BASE_URL}/v2/queries/latency/collections",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={
        "from": "2026-09-01",
        "to": "2026-09-08",
        "limit": 3,
    },
    timeout=30.0
)
if response.status_code == 200:
    data = response.json()
    for c in data["collections"]:
        print(f"{c['collection_name']:24s} {c['query_count']:6d} queries")
    if data["has_more"]:
        print(f"Showing {len(data['collections'])} of {data['total']}; "
              f"raise offset to {data['offset'] + data['limit']} for the next page")
else:
    print(f"Error: {response.status_code}")

{
  "has_more": true,
  "limit": 3,
  "offset": 0,
  "total": 12,
  "collections": [
    {
      "collection_name": "customer_forms",
      "query_count": 1902
    },
    {
      "collection_name": "policy_library",
      "query_count": 512
    },
    {
      "collection_name": "onboarding_docs",
      "query_count": 197
    }
  ]
}

The collections that ran queries in the window, most active first. For organizations with more collections than the metrics response returns series for, so a picker can search the rest without asking for every series at once.

Query parameters

fromstring or nullOptional

tostring or nullOptional

searchstring or nullOptional

Case-insensitive substring match on the collection name.

limitintegerOptional1-100Defaults to 25

offsetintegerOptional>=0Defaults to 0

collectionstring or nullOptional

api_versionstring or nullOptional

rerankstring or nullOptional

search_modestring or nullOptional

has_filterstring or nullOptional

Response

Successful Response

has_moreboolean

limitinteger

offsetinteger

totalinteger

Distinct collections matching the window and filters.

collectionslist of objectsOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

503

Service Unavailable Error