---
title: "Get the stats for a certain agent."
method: GET
path: "/api/v1/projects/{projectId}/stats"
tags: ["Agents"]
---

# Get the stats for a certain agent.

`GET /api/v1/projects/{projectId}/stats`

Retrieve statistical data for an agent (formerly known as project) using its unique projectId. This endpoint provides extensive statistics about the agent's performance, activity, or other relevant metrics.
Here is an example to a specific object stats: [API](https://github.com/Poll-The-People/customgpt-cookbook/blob/main/examples/Get_Project_Stats.ipynb) [SDK](https://github.com/Poll-The-People/customgpt-cookbook/blob/main/examples/SDK_Get_Project_Stats.ipynb).

## Path parameters

- `projectId` integer, required

## Response `200`

Agent stats

- object
  - `status` 'error' | 'success' — The status of the response
  - `data` object
    - `pages_found` integer — Number of documents added to the agent
    - `pages_crawled` integer — Number of documents successfully read by the the agent
    - `pages_indexed` integer — Number of documents available in the agent's knowledge
    - `crawl_credits_used` integer — Number of read credits used by the agent
    - `query_credits_used` integer — Number of query credits used by the agent
    - `total_queries` integer — Number of queries used by the agent
    - `total_words_indexed` integer — Number of word processing credits used by the agent
    - `total_storage_credits_used` integer — Number of words stored for the agent

## Other responses

- `400` — Bad Argument
- `401` — API Token is either missing or invalid
- `404` — Agent not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/poll-the-people/apis/customgpt-ai.md) · [All operations](https://skmtc.net/poll-the-people/apis/customgpt-ai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poll-the-people/customgpt-ai/revisions/b80e6dfcf78d/schema)