---
title: "Get detailed Consumption data"
method: GET
path: "/consumptions/detail"
tags: ["Consumption"]
---

# Get detailed Consumption data

`GET /consumptions/detail`

Returns the consumption of your organization over a specified period.

## Query parameters

- `after` string
- `limit` integer
- `from` string, date, required
- `to` string, date, required
- `breakdown_type` 'organization' | 'workspace'
- `workspace_ids` UUID[]

## Response `200`

Return the detailed consumption.

- GetConsumptionDetail200Response
  - `meta` PaginationWithUpdatedAt — Cursor based pagination
    - `next_cursor` string, nullable, required
    - `updated_at` string, date-time, required
  - `data` DetailedConsumption[]
    - `source` 'app' | 'api' | 'connector', required
    - `type` 'invited_signers' | 'electronic_seals' | 'identification_attempts' | 'archiving' | 'verifications', required
    - `level` 'simple' | 'advanced' | 'qualified' — Specifies the level of the consumed eSignature, eSeal and QES identification attempts: simple, advanced, or qualified. Only set when type is either `invited_signer`, `electronic_seals`, `identification_attempts`.
    - `verification_type` 'bank_account_connection_verification' | 'bank_account_lookup_verification' | 'bank_account_verification' | 'company_verification' | 'company_de_verification' | 'company_it_verification' | 'document_analysis_verification' | 'document_analysis_tax_notice_verification' | 'document_trust_advanced_verification' | 'document_trust_standard_verification' | 'identity_document_verification' | 'identity_video_face_recognition_verification' | 'certified_identity_pvid' | 'identity_video_verification' | 'proof_of_address_verification' | 'watchlist_verification'
    - `identification_mode` 'identity_verification' | 'saved_identity' — Only set if type is identification_attempts.
    - `workspace_id` string, uuid — Only set if breakdown is set on workspaces.
    - `value` integer, required — Count of items or file size in case of archiving.

## Other responses

- `400` — Bad request
- `401` — Access unauthorized
- `403` — Access forbidden
- `405` — This method is not allowed
- `429` — Too Many Requests, please try again later.
- `500` — Internal Server Error

---

[API](https://skmtc.net/yousign/apis/public-api-v3.md) · [All operations](https://skmtc.net/yousign/apis/public-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yousign/public-api-v3/revisions/8d258c0b45d6/schema)