---
title: "Observances"
method: GET
path: "/social-post-ideas/observances"
tags: ["Social Post Ideas"]
---

# Observances

`GET /social-post-ideas/observances`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/social-post-ideas/observances`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/social-post-ideas/observances/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Query parameters

- `month` integer, required
- `date` integer
- `socialProfileId` string

## Headers

- `Synup-Version` string, required
- `Authorization` string, required

## Response `200`

Successful response

- object
  - `data` object
    - `observances` ObservanceV2[]
      - `id` integer
      - `title` string
      - `description` string
      - `date` string
      - `imageUrl` string
      - `isMonthLong` boolean
      - `isRelevant` boolean
      - `ideasReady` boolean
      - `postIdeaId` string
      - `postImageUrl` string
      - `postTitle` string
      - `postType` string
      - `postContent` string
      - `postImagePrompt` string

## Other responses

- `401`: Unauthorized - Invalid or missing API key

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)