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

# Search customers having recent birthdays

`POST /customers/birthdays/recent`

## Request

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

Search for customers who had birthdays in the past 7 days (from 7 days ago to yesterday). 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)