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

# Usage

> Contracts sent this billing period against your plan limit, in total and per client, so platforms can bill their own customers.

Returns how many contracts reached a recipient in the current billing period, the plan limit, and the same count for each
client (tenant) of your account. A contract counts once: when it is first sent, opened, approved or signed. Drafts never count.

Use your API key; client tokens are not accepted, because usage covers the whole account.

### Query parameters

**clientKey** `string`

Only this client. Returns 404 if the client is not yours.

### Response

**periodStart** `string`

Start of the current billing period.

**periodEnd** `string`

End of the current billing period.

**limit** `number`

Contracts included this period, packs included.

**used** `number`

Contracts that reached a recipient this period.

**remaining** `number`

`limit` minus `used`, never below 0. At 0, sending a new contract returns 400 with a message about the monthly limit.

**clients** `object[]`

One entry per client: `clientKey`, `customKey`, `name` and `contracts` (sent this period).

```bash cURL theme={null}
curl -X GET 'https://api.sendforsign.com/api/usage' \
     -H 'X-Sendforsign-Key: YOUR_API_KEY'
```

```json Response theme={null}
{
  "periodStart": "2026-11-03 09:12:00",
  "periodEnd": "2026-12-02 09:12:00",
  "limit": 300,
  "used": 41,
  "remaining": 259,
  "clients": [
    { "clientKey": "CLIENT_KEY_1", "customKey": "customer_4812", "name": "Studio Nord", "contracts": 29 },
    { "clientKey": "CLIENT_KEY_2", "customKey": "customer_4813", "name": "Berg & Co", "contracts": 12 }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.