# Observances

```http
GET https://api.synup.com/api/v4/social-post-ideas/observances
```

Returns the observances (holidays, awareness days, etc.) for a given month, optionally scoped to a social profile and narrowed to a specific day. Each item includes whether ideas are ready and any generated post idea preview.

Source: https://developer.synup.com/api/social-post-ideas/observances

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `month` | integer | required | Month number (1-12). |
| `date` | integer | optional | Day of the month to narrow to. |
| `socialProfileId` | string | optional | Social profile ID to scope relevance/ideas to. |

## Header parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `Synup-Version` | string | required | API version date (YYYY-MM-DD). |

## Example request

```bash
curl -X GET 'https://api.synup.com/api/v4/social-post-ideas/observances' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json'
```

## Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |
| `401` | Unauthorized - Invalid or missing API key |
