---
title: "Search customers having upcoming birthdays"
method: POST
path: "/customers/birthdays/next"
tags: ["Customers"]
---

# Search customers having upcoming birthdays

`POST /customers/birthdays/next`

## Request

- Base URL: `https://api.surense.com/api/v1`
- URL: `https://api.surense.com/api/v1/customers/birthdays/next`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.surense.com/oauth/token` scopes: `customers:read`

Search for customers who have birthdays in the next 30 days (from tomorrow to 30 days from today). Returns a paginated list of customers with their birthday information.

## Request body

- SearchBirthdaysRequest: Request for searching customers with birthdays
  - `page` integer: Page number for pagination
  - `pageSize` integer: Number of items per page
  - `activeOnly` boolean: Filter to show only active customers

## Response `200`

OK

- PaginatedSearchResponseCustomerBirthday
  - `results` CustomerBirthday[]
    - `id` string, uuid
    - `name` string
    - `cellNumber` string
    - `email` string
    - `emailBounce` boolean
    - `gender` 1 | 2 | 3: Gender:<br/>1 - לא מוגדר<br/>2 - זכר<br/>3 - נקבה
    - `birthDate` string, date
    - `statusId` string, uuid
    - `classId` string, uuid
    - `appMailAddress` string
    - `age` integer
  - `hasNextPage` boolean
  - `totalElements` integer

---

[API](https://skmtc.dev/surense/apis/customer-service.md) - [All operations](https://skmtc.dev/surense/apis/customer-service/llms.txt) - [OpenAPI document](https://skmtc.dev/surense/apis/customer-service/revisions/f794569f5ccb?raw)