---
title: "Get paid requests"
method: GET
path: "/v2/paid-request-totals"
---

# Get paid requests

`GET /v2/paid-request-totals`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/paid-request-totals`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/paid-request-totals/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to retrieve the total, used, and remaining paid API requests for the current subscription.

## Response `200`

Successful response. Returns the total, used, and remaining API limits.

- object
  - `data` object, required: Paid API request usage of the current subscription.
    - `used` number, required: Number of paid requests used.
    - `total` number, required: Total number of paid requests in the subscription.
    - `status` string, required: Status of the subscription, for example `active`.
    - `expired` number, required: Unix timestamp of when the subscription expires.
    - `used_api` integer: Number of paid requests used via the API.
    - `used_web` integer: Number of paid requests used via the SignNow web app.
    - `remaining` number, required: Number of paid requests left.
    - `subscription_id` string, required: ID of the subscription: a string of 32 to 64 letters and digits. An empty string when `subscription_type` is `development` or `unlimited`.
    - `used_integration` integer: Number of paid requests used via integrations.
    - `subscription_type` string: Type of the subscription: `paid`, `development`, or `unlimited`.
    - `has_payment_method` boolean: `true` if a payment method is added to the subscription.
    - `overdraft_percentage` string: Percentage of requests allowed above the limit. `null` if overdraft is not available.

## Other responses

- `400`: Wrong, expired, or missing token.
- `403`: The user doesn't have an API subscription plan.

---

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