--- title: "Changes to Get org-wide usage summary" method: GET path: "/usage" --- # Changes to Get org-wide usage summary `GET /usage` > Every recorded change to this operation, newest first. ## Timeline Changed in 4 of 49 revisions. - **2026-02-08** `37bce0c9a4d7`: 3 breaking, 3 warning, 12 info - **2026-02-08** `4f8eeb0b9933`: 138 warning - **2026-02-08** `80a061ee3002`: 2 info - **2026-01-29** `1949bcfc8775`: 1 info ## Changes - **2026-02-08** `37bce0c9a4d7`: 3 breaking, 3 warning, 12 info - removed the required property `data/billing` from the response with the `200` status - removed the required property `data/rateLimit` from the response with the `200` status - removed the required property `data/sendLimit` from the response with the `200` status - added the new `infrastructure_error` enum value to the `error/code` response property for the response status `401` - added the new `infrastructure_error` enum value to the `error/code` response property for the response status `429` - added the new `infrastructure_error` enum value to the `error/code` response property for the response status `500` - api operation id `usage_retrieve_limits` removed and replaced with `usage_retrieve` - endpoint reactivated - added the new optional `query` request parameter `period` - added the new optional `query` request parameter `timezone` - added the non-success response with the status `503` - removed the `postal_error` enum value from the `error/code` response property for the response status `401` - removed the `postal_error` enum value from the `error/code` response property for the response status `429` - removed the `postal_error` enum value from the `error/code` response property for the response status `500` - added the required property `data/emails` to the response with the `200` status - added the required property `data/period` to the response with the `200` status - added the required property `data/rates` to the response with the `200` status - added the required property `data/tenants` to the response with the `200` status - **2026-02-08** `4f8eeb0b9933`: 138 warning - added the new `already_exists` enum value to the `error/code` response property for the response status `401` - added the new `already_exists` enum value to the `error/code` response property for the response status `429` - added the new `already_exists` enum value to the `error/code` response property for the response status `500` - added the new `attachment_too_large` enum value to the `error/code` response property for the response status `401` - added the new `attachment_too_large` enum value to the `error/code` response property for the response status `429` - added the new `attachment_too_large` enum value to the `error/code` response property for the response status `500` - added the new `authentication_required` enum value to the `error/code` response property for the response status `401` - added the new `authentication_required` enum value to the `error/code` response property for the response status `429` - added the new `authentication_required` enum value to the `error/code` response property for the response status `500` - added the new `billing_error` enum value to the `error/code` response property for the response status `401` - added the new `billing_error` enum value to the `error/code` response property for the response status `429` - added the new `billing_error` enum value to the `error/code` response property for the response status `500` - added the new `billing_not_configured` enum value to the `error/code` response property for the response status `401` - added the new `billing_not_configured` enum value to the `error/code` response property for the response status `429` - added the new `billing_not_configured` enum value to the `error/code` response property for the response status `500` - added the new `credential_not_found` enum value to the `error/code` response property for the response status `401` - added the new `credential_not_found` enum value to the `error/code` response property for the response status `429` - added the new `credential_not_found` enum value to the `error/code` response property for the response status `500` - added the new `credential_on_hold` enum value to the `error/code` response property for the response status `401` - added the new `credential_on_hold` enum value to the `error/code` response property for the response status `429` - added the new `credential_on_hold` enum value to the `error/code` response property for the response status `500` - added the new `credential_revoked` enum value to the `error/code` response property for the response status `401` - added the new `credential_revoked` enum value to the `error/code` response property for the response status `429` - added the new `credential_revoked` enum value to the `error/code` response property for the response status `500` - added the new `delivery_not_found` enum value to the `error/code` response property for the response status `401` - added the new `delivery_not_found` enum value to the `error/code` response property for the response status `429` - added the new `delivery_not_found` enum value to the `error/code` response property for the response status `500` - added the new `domain_already_exists` enum value to the `error/code` response property for the response status `401` - added the new `domain_already_exists` enum value to the `error/code` response property for the response status `429` - added the new `domain_already_exists` enum value to the `error/code` response property for the response status `500` - added the new `domain_not_found` enum value to the `error/code` response property for the response status `401` - added the new `domain_not_found` enum value to the `error/code` response property for the response status `429` - added the new `domain_not_found` enum value to the `error/code` response property for the response status `500` - added the new `domain_not_verified` enum value to the `error/code` response property for the response status `401` - added the new `domain_not_verified` enum value to the `error/code` response property for the response status `429` - added the new `domain_not_verified` enum value to the `error/code` response property for the response status `500` - added the new `email_not_found` enum value to the `error/code` response property for the response status `401` - added the new `email_not_found` enum value to the `error/code` response property for the response status `429` - added the new `email_not_found` enum value to the `error/code` response property for the response status `500` - added the new `external_id_already_exists` enum value to the `error/code` response property for the response status `401` - …98 more - **2026-02-08** `80a061ee3002`: 2 info - api operation id `usage_retrieve` removed and replaced with `usage_retrieve_limits` - endpoint deprecated - **2026-01-29** `1949bcfc8775`: 1 info - endpoint added --- [Operation](https://skmtc.dev/arkhq-io/apis/ark-email-api/docs/usage/get.md) - [API](https://skmtc.dev/arkhq-io/apis/ark-email-api.md) - [Page](https://skmtc.dev/arkhq-io/apis/ark-email-api/changes/usage/get)