---
title: "List birthdays (v2)"
method: GET
path: "/v2/contacts/birthdays"
tags: ["contacts"]
---

# List birthdays (v2)

`GET /v2/contacts/birthdays`

Return every contact that has a stored birthday, as a light card projection: `{ data: { birthdays: [{ contact_id, full_name, image_url, job_title, company, birthday_month, birthday_day, birthday_year, ...socials, contact_emails, contact_phone_numbers }] } }`. Ordered by month then day. Powers the Birthdays page (today / upcoming / by-month groupings are computed client-side).

## Response `200`

Successful response

- object
  - `data` object, required
    - `birthdays` object[], required
      - `contact_id` string, required
      - `full_name` string, nullable, required
      - `first_name` string, nullable, required
      - `image_url` string, nullable, required
      - `job_title` string, nullable, required
      - `company` string, nullable, required
      - `birthday_month` integer, required
      - `birthday_day` integer, required
      - `birthday_year` integer, nullable, required
      - `last_dismissal_year` integer, nullable, required
      - `linkedin` string, nullable, required
      - `twitter` string, nullable, required
      - `facebook` string, nullable, required
      - `instagram` string, nullable, required
      - `telegram` string, nullable, required
      - `tiktok` string, nullable, required
      - `youtube` string, nullable, required
      - `contact_emails` object[], required
        - `id` string, required
        - `email` string, required
      - `contact_phone_numbers` object[], required
        - `id` string, required
        - `phone_number` string, required
        - `phone_number_sanitized` string, nullable, required
    - `pagination` object
      - `nextCursor` string, nullable
      - `count` integer

## 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-09-07** `01acf4e70493` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/getdex/apis/dex-public-api/changes/v2/contacts/birthdays/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.dev/getdex/apis/dex-public-api/revisions/4797af6dcfb7?raw)