Get the quotas of a person in a project

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/projects/{project_id}/quotas/persons/{person_id}
Jwt authorization

Get the quota statistics of a person in a project. A quota counts the shots that the person ended. A manager or a supervisor of the project can read the quotas of all the persons. Other users can read their own quotas only. Clients cannot use this route.

Path parameters

  • project_id string(uuid) Required

    Unique identifier of the project

  • person_id string(uuid) Required

    Unique identifier of the person

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, weigtheddone, feedback, or done. Default value is weighted.

  • studio_id string(uuid)

    Get only the persons of this studio

Responses

  • 200 application/json

    The quota statistics

    Hide response attribute Show response attribute object
    • * object Additional properties
      Hide * attributes Show * attributes object
      • count number

        Shots counted. In weighted modes a shot is split over the days it was worked on, so counts are fractions rounded to 2 decimals.

      • frames integer
  • 400

    count_mode is not valid

  • 403

    You cannot read the quotas of this person, or you are a client

GET /data/projects/{project_id}/quotas/persons/{person_id} 
curl -X GET "http://api.example.com/data/projects/a24a6ea4-ce75-4665-a070-57453082c25/quotas/persons/a24a6ea4-ce75-4665-a070-57453082c25?count_mode=weighted&studio_id=a24a6ea4-ce75-4665-a070-57453082c25" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
import requests

url = "http://api.example.com/data/projects/a24a6ea4-ce75-4665-a070-57453082c25/quotas/persons/a24a6ea4-ce75-4665-a070-57453082c25"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json"
}
params = {
    "count_mode": "weighted",
    "studio_id": "a24a6ea4-ce75-4665-a070-57453082c25"
}
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) 
{
  "additionalProperty1": {
    "count": 15,
    "frames": 360
  },
  "additionalProperty2": {
    "count": 15,
    "frames": 360
  }
}