---
title: "Get Electronic Seals consumption records"
method: GET
path: "/consumptions/records/electronic_seals"
tags: ["Consumption"]
---

# Get Electronic Seals consumption records

`GET /consumptions/records/electronic_seals`

Returns the list of Electronic Seal consumption records.

## Query parameters

- `after` string
- `limit` integer
- `created_at` object — Filter by date of creation.

## Response `200`

OK

- GetConsumptionsRecordsElectronicSeals200Response
  - `meta` Pagination, required — Metadata about the response.
    - `next_cursor` string, nullable, required — Token to get the next page of results. If `null`, there are no more pages.
  - `data` ElectronicSealsConsumption[], required
    - `seal_id` string, uuid, required
    - `document_id` string, uuid, required
    - `seal_level` 'electronic_signature' | 'advanced_electronic_signature' | 'qualified_electronic_signature_external', required — Level of the Electronic Seal applied.
    - `created_at` string, required — Creation time of the record
    - `source` string, required — Origin of the operation.
    - `external_id` string, nullable, required — Optional user-defined identifier.
    - `certificate_id` string, uuid, nullable, required
    - `workspace_id` string, uuid, required
    - `authentication_key` string, nullable, required — Identifier of the key used for the operation.
    - `workspace_name` string, required — Name of the workspace.
    - `workspace_external_name` string, nullable, required — External name of the workspace.

## Other responses

- `400` — Bad request
- `401` — Access unauthorized
- `403` — Access forbidden
- `404` — Resource not found
- `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)
