---
title: "Get remaining plan limits"
method: GET
path: "/api/reach/v1/profiles/{profileUuid}/limits"
tags: ["Reach: Profiles"]
---

# Get remaining plan limits

`GET /api/reach/v1/profiles/{profileUuid}/limits`

Get how much of the plan is left for the current period.

Two things to keep in mind before you build alerting on this. The period is a calendar month
rather than a billing anniversary, so the counters reset on the 1st no matter when the
subscription started. And usage is tracked per order, so every profile on the same order shares
one pool and reports the same numbers here. Only the current period is available, past usage is
not kept.

## Path parameters

- `profileUuid` string, required

## Response `200`

Success response

- ReachV1ProfilesPlanLimitsResource — What the plan allows and what is left of it for the current period. `emails` counts every email sent. `recipients` counts the distinct contacts emailed - it is not the size of the contact list, a contact emailed three times counts once and a contact never emailed does not count at all. `ai_credits` counts the AI generations used, and its limit includes any extra credits bought on top of the plan.
  - `emails` ReachV1ProfilesPlanLimitUsageResource — Allowance, consumption and headroom of a single plan limit for the current period.
    - `limit` integer — The allowance for the current period.
    - `used` integer — How much of the allowance has been consumed so far.
    - `remaining` integer — Headroom left. Floors at 0, so it never reports a negative overage.
  - `recipients` ReachV1ProfilesPlanLimitUsageResource — Allowance, consumption and headroom of a single plan limit for the current period.
    - `limit` integer — The allowance for the current period.
    - `used` integer — How much of the allowance has been consumed so far.
    - `remaining` integer — Headroom left. Floors at 0, so it never reports a negative overage.
  - `ai_credits` ReachV1ProfilesPlanLimitUsageResource — Allowance, consumption and headroom of a single plan limit for the current period.
    - `limit` integer — The allowance for the current period.
    - `used` integer — How much of the allowance has been consumed so far.
    - `remaining` integer — Headroom left. Floors at 0, so it never reports a negative overage.
  - `period_start` string, date-time — Start of the current period. Periods are calendar months rather than billing anniversaries, so the counters reset at midnight UTC on the 1st no matter when the subscription started.
  - `period_end` string, date-time — End of the current period, that is the last moment of the calendar month.

## Other responses

- `401` — Unauthenticated response
- `500` — Error response

---

[API](https://skmtc.net/hostinger/apis/hostinger-api.md) · [All operations](https://skmtc.net/hostinger/apis/hostinger-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hostinger/hostinger-api/revisions/804fe7912e4c/schema)