> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contact Events

> Get contact events for a specific month and year



## OpenAPI

````yaml GET /contacts/events
openapi: 3.1.0
info:
  title: Postable API
  version: 1.0.0
  description: API for managing contacts and groups in Postable
servers:
  - url: https://www.postable.com/api/v1
    description: API base URL
security: []
paths:
  /contacts/events:
    get:
      summary: Get contact events for a specific month and year
      description: >-
        Returns a list of contact events (birthdays and anniversaries) for the
        specified month and year
      parameters:
        - name: year
          in: query
          required: true
          schema:
            type: integer
            example: 2024
        - name: month
          in: query
          required: true
          schema:
            type: integer
            minimum: 1
            maximum: 12
            example: 1
      responses:
        '200':
          description: List of contact events
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  required:
                    - title
                    - text
                    - event_date
                    - uuid
                  properties:
                    title:
                      type: string
                      description: Formatted date of the event
                      example: January 1st
                    text:
                      type: string
                      description: Description of the event (e.g. "John's Birthday")
                      example: John Smith's Birthday
                    event_date:
                      type: string
                      format: date-time
                      description: ISO8601 formatted date-time string
                      example: '2024-01-01T00:00:00+00:00'
                    uuid:
                      type: string
                      format: uuid
                      description: UUID of the contact associated with the event
                      example: 123e4567-e89b-12d3-a456-426614174000
      security:
        - sanctum: []
components:
  securitySchemes:
    sanctum:
      type: http
      scheme: bearer
      bearerFormat: JWT

````