> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Querying deploy statistics

Read aggregated statistics for a deploy with the [Public API
(V2)](/api/v2/overview). The endpoint authenticates with your personal API token.

## Get deploy statistics

<CodeGroup>
  ```shell Endpoint theme={null}
  POST /api/v2/deploys/stats
  ```
</CodeGroup>

### Request body

| Field       | Type   | Required | Description                                     |
| ----------- | ------ | -------- | ----------------------------------------------- |
| `site_id`   | string | Yes      | Site to query.                                  |
| `revision`  | string | Yes      | Git revision or deploy identifier.              |
| `namespace` | string | No       | Namespace to filter by, such as `web` or `api`. |

<CodeGroup>
  ```json body.json theme={null}
  {
    "site_id": "YOUR-SITE-ID",
    "revision": "abc123",
    "namespace": "web"
  }
  ```
</CodeGroup>

### Response

Returns the deploy's `throughput` (total request count), `mean` (average response
time in milliseconds), and `error_rate` (a percentage from 0 to 100).
