Get the quota shots of a person for a month

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}/quota-shots/month/{year}/{month}
Jwt authorization

Get the shots that count in the quota of a person for a month. A quota shot is a shot that the person ended. An administrator reads the quotas of all persons. The person reads their own quotas. Give project_id to read the quotas of another person. You must then be a manager or a supervisor in the team of this project. The role held on the project team applies. A manager or a supervisor who gives a project_id of a project they are not a team member of gets a 403, also for their own quotas.

Path parameters

  • person_id string(uuid) Required

    Person unique identifier

  • year integer Required

    Year, for example 2026

  • month integer Required

    Month, from 1 to 12

    Minimum value is 1, maximum value is 12.

Query parameters

  • count_mode string

    How to count the shots: weighted, weighteddone, feedback or done. The default value is weighted. The weighted modes give each shot the part of its work time that is in the period. The other modes count each shot on its end date. The feedback modes end a shot at its first feedback. The done modes end a shot when it is done.

    Values are weighted, weighteddone, feedback, or done.

  • project_id string(uuid)

    Get only the shots of this project

  • task_type_id string(uuid)

    Get only the shots of this task type

Responses

  • 200 application/json

    The list of quota shots

    A serialized shot, with its project_id, full_name and the weight it carries in the period.
  • 400

    The date or count_mode is not valid

  • 403

    You cannot read the quotas of this person, or the person is a bot

  • 404

    The person does not exist

GET /data/persons/{person_id}/quota-shots/month/{year}/{month} 
curl -X GET "http://api.example.com/data/persons/a24a6ea4-ce75-4665-a070-57453082c25/quota-shots/month/2022/7?count_mode=weighted" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
import requests

url = "http://api.example.com/data/persons/a24a6ea4-ce75-4665-a070-57453082c25/quota-shots/month/2022/7"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json"
}
params = {
    "count_mode": "weighted"
}
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) 
[
  {}
]