---
title: "Findings about your brand, newest first"
method: GET
path: "/alerts"
---

# Findings about your brand, newest first

`GET /alerts`

## Request

- Base URL: `https://app.aimentiontracker.ai/api/v1`
- URL: `https://app.aimentiontracker.ai/api/v1/alerts`
- Auth: API key in header `X-API-Key`

AN EMPTY LIST DOES NOT MEAN NOTHING CHANGED. A finding is raised only when both comparison windows carry enough answers AND the change is larger than its own margin of error. Read an empty list as 'no change large enough to distinguish from noise at this sample size'. GET /me returns the thresholds.

## Query parameters

- `limit` integer
- `brand` string

## Response `200`

OK

- object
  - `data` Alert[], required
    - `id` string, required: Opaque public id, alr_<12>. Use it to dedupe across polls.
    - `kind` string, required: Finding type, e.g. visibility_drop.
    - `title` string, required: One line.
    - `detail` string: The explanation, including the numbers behind it.
    - `facts` object: The figures the finding was computed from.
    - `created_at` string, required: ISO timestamp.
    - `read` boolean, required: Whether it has been seen in the dashboard.
  - `meta` object, required
    - `generated_at` string, date-time
    - `brand` BrandRef: Which brand a response describes. Present in meta on every data endpoint.
      - `id` string, required: Pass as ?brand=.
      - `name` string, required: Display name.
    - `note` string

## Other responses

- `400`: brand_required, or a cursor that does not belong to this brand.
- `401`: Missing, malformed, revoked or expired key.
- `402`: The organisation has never subscribed, or the plan excludes the API.
- `403`: The key lacks the required scope.
- `404`: No such brand, or the brand has not finished setup.
- `429`: Rate limit exceeded. Carries Retry-After.

---

[API](https://skmtc.dev/aimentiontracker/apis/aimentiontracker-api.md) · [All operations](https://skmtc.dev/aimentiontracker/apis/aimentiontracker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aimentiontracker/apis/aimentiontracker-api/revisions/c3329178c84c?raw)