---
title: "BillingPeriodUsages (DeepL)"
description: "Billing Period Usages"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/deepl/DeepL.Account.BillingPeriodUsages
original: https://documentation.invantive.eu/en/datamodels/deepl/DeepL.Account.BillingPeriodUsages
updated: 2026-11-01T16:36:06Z
license: https://documentation.invantive.eu/en/
---

# BillingPeriodUsages: DeepL Billing Period Usages

`read only` `REST`

- Catalog: `DeepL`
- Schema: `Account`
- Label: Billing Period Usages

Can only retrieve data.

## Summary

The usage and limits of the current billing period, which runs from the day of the month the subscription started.

## API Source

- Endpoint: `/v2/usage`

## Performance Characteristics

| Characteristic | Value |
|---|---:|
| Average access latency (ms) | 31 |

## Table Columns

The columns of the table `BillingPeriodUsages` are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

| Name | Data Type | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `api_key_character_count` | `int64` | itgen_dpl_api_key_character_count | [ ] | filters on the platform, writable | Characters used by the key of this connection so far. |
| `api_key_character_limit` | `int64` | itgen_dpl_api_key_character_limit | [ ] | filters on the platform, writable | Character limit of the key of this connection. |
| `character_count` | `int64` | itgen_dpl_character_count | [ ] | filters on the platform, writable | Characters translated and improved so far in the billing period, over the whole account. |
| `character_limit` | `int64` | itgen_dpl_character_limit | [ ] | filters on the platform, writable | Maximum number of characters in the billing period; the Cost Control limit when one is set. |
| `document_count` | `int64` | itgen_dpl_document_count | [ ] | filters on the platform, writable | Documents translated so far; only on accounts with a document limit. |
| `document_limit` | `int64` | itgen_dpl_document_limit | [ ] | filters on the platform, writable | Maximum number of documents in the billing period. |
| `end_time` | `datetime` | itgen_dpl_end_time | [ ] | filters on the platform, writable | End of the billing period (UTC). |
| `speech_to_speech_minutes_count` | `int64` | itgen_dpl_speech_to_speech_minutes_count | [ ] | filters on the platform, writable | Minutes of speech to speech used so far. |
| `speech_to_speech_minutes_limit` | `int64` | itgen_dpl_speech_to_speech_minutes_limit | [ ] | filters on the platform, writable | Maximum minutes of speech to speech in the billing period. |
| `speech_to_text_minutes_count` | `int64` | itgen_dpl_speech_to_text_minutes_count | [ ] | filters on the platform, writable | Minutes of speech to text used so far. |
| `speech_to_text_minutes_limit` | `int64` | itgen_dpl_speech_to_text_minutes_limit | [ ] | filters on the platform, writable | Maximum minutes of speech to text in the billing period. |
| `start_time` | `datetime` | itgen_dpl_start_time | [ ] | filters on the platform, writable | Start of the billing period (UTC). |
| `team_document_count` | `int64` | itgen_dpl_team_document_count | [ ] | filters on the platform, writable | Documents translated by the whole team so far. |
| `team_document_limit` | `int64` | itgen_dpl_team_document_limit | [ ] | filters on the platform, writable | Maximum number of documents of the team in the billing period. |

## Sample Queries

```sql
select bpu.character_count
,      bpu.character_limit
,      bpu.end_time
from   DeepL.Account.BillingPeriodUsages bpu
```

