---
title: "Account document KPIs"
method: GET
path: "/v1/accounts/{accountId}/stats"
tags: ["Accounts"]
---

# Account document KPIs

`GET /v1/accounts/{accountId}/stats`

## Request

- Base URL: `https://api.assinafy.com.br`
- URL: `https://api.assinafy.com.br/v1/accounts/{accountId}/stats`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

Precomputed per-account document-funnel KPIs. `granularity=monthly` (default) returns the last 12 months, most recent first; `granularity=daily` with `month=YYYY-MM` returns that month's days. Series are zero-filled. Requires the `account:read` OAuth scope.

[Copy as Markdown](https://api.assinafy.com.br/v1/docs/markdown?method=get&path=%2Fv1%2Faccounts%2F%7BaccountId%7D%2Fstats) [Open in ChatGPT](https://chatgpt.com/?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dget%26path%3D%252Fv1%252Faccounts%252F%257BaccountId%257D%252Fstats%20and%20help%20me%20integrate%20this%20endpoint.) [Open in Claude](https://claude.ai/new?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dget%26path%3D%252Fv1%252Faccounts%252F%257BaccountId%257D%252Fstats%20and%20help%20me%20integrate%20this%20endpoint.)

## Path parameters

- `accountId` string, required

## Query parameters

- `granularity` 'monthly' | 'daily'
- `month` string

## Response `200`

KPI series

- object: Standard success wrapper. Operations add their own `data`.
  - `status` integer: HTTP status code, mirrored in the body.
  - `message` string: Human-readable message; empty on success.
  - `data` DocumentStatsRow[]
    - `period` string: `YYYY-MM` (monthly) or `YYYY-MM-DD` (daily).
    - `documents_uploaded` integer
    - `documents_sent` integer
    - `signature_requests` integer
    - `signature_requests_notification_email` integer: Requests notified by e-mail.
    - `signature_requests_notification_whatsapp` integer: Requests notified by WhatsApp.
    - `signature_requests_notification_bypass` integer: Requests with no notification sent (`Bypass`).
    - `signature_requests_verification_email` integer: Requests verified by an e-mail token.
    - `signature_requests_verification_whatsapp` integer: Requests verified by a WhatsApp token.
    - `signature_requests_verification_bypass` integer: Requests signed without token verification (`Bypass`).
    - `signature_requests_verification_digital_certificate` integer: Requests signed with the signer's own ICP-Brasil digital certificate.
    - `signature_requests_viewed` integer: Signature requests whose document was first viewed during the period.
    - `signature_requests_completed` integer: Signature requests completed by individual signers during the period.
    - `documents_certified` integer

## Other responses

- `400`: One or more fields failed validation.
- `401`: Missing or invalid credentials.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/assinafy/apis/assinafy-api-reference.md) - [All operations](https://skmtc.dev/assinafy/apis/assinafy-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/assinafy/apis/assinafy-api-reference/revisions/f7da81a5567e?raw)