Get the day offs of a person for a week

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

mcp.json 
{
  "Kitsu API MCP server": {
    "url": "https://api-docs.kitsu.cloud/mcp"
  }
}
Close
GET /data/persons/{person_id}/day-offs/week/{year}/{week}
Jwt authorization

Get the day offs of a person for a week. 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

  • week integer Required

    Week number of the ISO year, from 1 to 53

    Minimum value is 1, maximum value is 52.

Responses

  • 200 application/json

    The list of day offs
  • 400

    The year or the week 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/week/{year}/{week} 
curl -X GET "http://api.example.com/data/persons/a24a6ea4-ce75-4665-a070-57453082c25/day-offs/week/2022/35" \
  -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/week/2022/35"
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) 
[
  {}
]