---
title: "Count notes"
method: GET
path: "/v1/timeline/count"
tags: ["timeline"]
---

# Count notes

`GET /v1/timeline/count`

Return the total number of notes matching the given filters. Useful for displaying counts without fetching full note records.

## Query parameters

- `where` object
  - `has_contacts` union
    - object
      - `not` union, required
        - string
        - string[]
    - boolean
    - string
    - string[]
  - `created_at` object
    - `gte` string, date-time, required
    - `lte` string, date-time, required
  - `has_calendar_event` union
    - boolean
    - string

## Response `200`

Successful response

- object
  - `error` boolean, required
  - `data` object, required
    - `count` integer, required

## Other responses

- `400` — Request body failed validation.
- `401` — Missing or invalid API key.
- `403` — Valid key, insufficient permission.
- `404` — Resource does not exist.
- `429` — Rate limit exceeded.
- `500` — Unexpected server error.

---

[API](https://skmtc.net/getdex/apis/dex-public-api.md) · [All operations](https://skmtc.net/getdex/apis/dex-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getdex/dex-public-api/revisions/9d0dd2de771c/schema)