Get the day offs of a person for a year

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://api-docs.kitsu.cloud/mcp

Standard setup for AI tools providing an mcp.json file

{
  "Kitsu API MCP server": {
    "url": "https://api-docs.kitsu.cloud/mcp"
  }
}

GET /data/persons/{person_id}/day-offs/year/{year}

Jwt authorization

Get the day offs of a person for a year. An administrator, the person, and a manager of a project where the person is a team member get the day offs with their description. A supervisor of such a project who shares a department with the person gets the day offs without their description. A supervisor without department gets them for all the persons of their projects. The manager and supervisor roles are the roles held on the project team. Other users cannot read them.

Path parameters

person_id string(uuid) Required

Person unique identifier
year integer Required

Year, for example 2026

Responses

200 application/json

The list of day offs
400

The year is not valid
403

You cannot read the day offs of this person, or the person is a bot
404

The person does not exist

GET /data/persons/{person_id}/day-offs/year/{year}

curl -X GET "http://api.example.com/data/persons/a24a6ea4-ce75-4665-a070-57453082c25/day-offs/year/2022" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

import requests

url = "http://api.example.com/data/persons/a24a6ea4-ce75-4665-a070-57453082c25/day-offs/year/2022"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json"
}
params = {}
payload = None

response = requests.get(
    url,
    headers=headers,
    params=params,
    json=payload
)

response.raise_for_status()

if response.content:
    print(response.json())

Response examples (200)

[
  {}
]