Get the time spents of a person for a date

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}/time-spents/{date}

Jwt authorization

Get the time spent entries of a person for one date. An administrator and the person get all the entries. A manager gets the entries of the projects they manage. A supervisor gets the entries of the projects they supervise, for the task types of their departments. A supervisor without department gets all the task types. Other users cannot read the time spents of other persons. You cannot read the time spents of a bot. The manager and supervisor roles are the roles held on the project team.

Path parameters

person_id string(uuid) Required

Person unique identifier
date string(date) Required

Date in the YYYY-MM-DD format

Responses

200 application/json

The list of time spent entries
Hide response attributes Show response attributes object
- id string(uuid)
  
  Time spent unique identifier
- person_id string(uuid)
  
  Person unique identifier
- duration number(float)
  
  Time spent duration in hours
- date string(date)
  
  Date of time spent entry
400

The date is not valid
403

You cannot read the time spents of this person, or the person is a bot
404

The person does not exist

GET /data/persons/{person_id}/time-spents/{date}

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

import requests

url = "http://api.example.com/data/persons/a24a6ea4-ce75-4665-a070-57453082c25/time-spents/2022-07-12"
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)

[
  {
    "id": "a24a6ea4-ce75-4665-a070-57453082c250",
    "person_id": "b35b7fb5-df86-5776-b181-68564193d360",
    "duration": 8.5,
    "date": "2022-07-12"
  }
]