---
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.
- `409` — Request conflicts with the current state of the resource.
- `429` — Rate limit exceeded.
- `500` — Unexpected server error.

## Changes

- **2026-08-27** `a2f71a243839` — 2 info
  - api operation id `countNotesV1` was added
  - added the non-success response with the status `409`

[Change history](https://skmtc.dev/getdex/apis/dex-public-api/changes/v1/timeline/count/get.md)

---

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