Themes

Retrieve all themes from the database with optional filtering by month, year, and name search

get/themes

Request

  • Base URL: http://localhost:8080/api/v1
  • URL: http://localhost:8080/api/v1/themes
  • Auth: none declared

Query parameters

pageinteger

Page Number of pagination

limitinteger

Number of Items per page in pagination

monthinteger

Filter themes by month (1-12)

yearinteger

Filter themes by year

searchstring

Search themes by name (case-insensitive, partial matching)

Response

List of themes (filtered and paginated based on query parameters)

idstring uuid required

Unique identifier for the theme

namestring required

Name of the theme

monthinteger required

Month of the theme (1-12)

yearinteger required

Year of the theme (e.g., 2024)

created_atstring date-time required

When the theme was created

updated_atstring date-time required

When the theme was last updated

Example response

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Winter Wonderland",
    "month": 12,
    "year": 2024,
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:35:00Z"
  }
]

Changes

    • ○

      added the new optional query request parameter month

    • ○

      added the new optional query request parameter search

    • ○

      added the new optional query request parameter year

    • ○

      added the non-success response with the status

    • ○

      added the new optional query request parameter limit

    • ○

      added the new optional query request parameter page