# Search Push Content

> Read what the banners of pushed notifications may show, with a content key.

Canonical URL: https://docs.botyard.io/docs/api/push-registrations/search_push_content_v1_public_push_registrations_content_search_post

`POST /v1/public/push-registrations/content/search`

Read what the banners of pushed notifications may show, with a content key.

A wrong key, or a registration that is unknown, disabled or has no key, is a
404. Otherwise each requested notification is either in ``items`` or left out.

## Request body

`application/json`: PushContentSearchRequest (required)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `registration_id` | string (uuid4) | yes | The registration the push was sent to (`rid`). |
| `content_key` | string | yes | The registration's current content key. |
| `notification_ids` | array of string (uuid4) | yes | Notifications to read (`nid` of each push), each at most once. Per-item: an id that is unknown, not pushed to this registration's user, or older than the push expiry is left out of the result, without saying why. |
| `cached_avatar_digests` | array of string | no | Avatar digests the device already holds; their bytes are not sent again. Duplicates are ignored. |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| `200` | Successful Response | PushContentSearchResponse |
| `default` | RFC 9457 Problem Details error response | ProblemDetails |

Full schemas: operation `search_push_content_v1_public_push_registrations_content_search_post` in the OpenAPI spec at https://api.botyard.io/openapi.json.