Limits

Metronome enforces two categories of limits: platform limits cap the number of objects you can create within your account, and API rate limits cap how frequently you can call each endpoint. The below tables detail default limits only. Limits can be configurable per client - if you have custom limits or need higher limits, reach out to your Metronome representative for more information.

API rate limits

All limits are measured in requests per second. Exceeding a limit returns a 429 Too Many Requests response.

Tier	Req / sec	Representative endpoints
Global API rate limit	2,750	All endpoints combined
Event ingestion	1,100	-`POST /v1/ingest`
High frequency read operations	220	-`GET /v1/customers` - `GET /v1/customers/` - `GET /v1/billable-metrics` - `GET /v1/customers//billable-metrics` - `POST /v1/usage/groups`
Standard operations	55	-`POST /v1/customers` - `POST /v1/contracts/create` -`POST /v2/contracts/get` - `POST/v1/alerts/create` - `POST /v1/customer-alerts/get` -`GET /v1/billable-metrics/` - `POST /v1/billable-metrics/create` - `POST /v1/dashboards/getEmbeddableUrl`
List contract, balances, or invoices	11	-`POST /v1/contracts/customerBalances/getNetBalance` -`GET /v1/customers//invoices` - `POST /v1/contracts/customerBalances/list` - `POST /v2/contracts/list`
Default	8	All other endpoints

To understand the rate limit for a specific endpoint not listed here, or to request a limit increase, contact Metronome support.

Platform limits

All limits listed below are configured per-environment.

Limit	Default Value
Total contracts per customer	20
Active contracts per customer	5
Subscriptions per contract	20
Seats per subscription	1,000
Account hierarchy children per parent	10
Group keys per billable metric	5
Active threshold notifications configured to apply to all customers	300
Active threshold notifications configured per customer	1,200
Active webhook destinations	5
Custom fields per object	50

GET STARTED

ESSENTIALS

ENDPOINTS

API rate limits

Platform limits

​API rate limits

​Platform limits

API rate limits

Platform limits