documentation/content/en/api/rate-limits.md

---
title: Rate limits
description: Defining how often you can call the REST API
menu:
  docs:
    weight: 30
    parent: api
---

## Headers

Rate limit information is returned in the response headers:

`X-RateLimit-Limit`
: Number of requests permitted per time period

`X-RateLimit-Remaining`
: Number of requests you can still make

`X-RateLimit-Reset`
: Timestamp when your rate limit will reset

{{< hint style="info" >}}
An API method can be subject to multiple overlapping rate limits. The headers return information about the one you are closest to exceeding.
{{</ hint >}}

## Limits

By default, the following limits are hardcoded:

### Per account

All endpoints and methods can be called 300 times within 5 minutes.

#### Uploading media

`POST /api/v1/media` can be called 30 times within 30 minutes.

#### Deleting statuses

Either `DELETE /api/v1/statuses/:id` or `POST /api/v1/statuses/:id/unreblog` can be called 30 times within 30 minutes.

### Per IP

All endpoints and methods can be called 300 times within 5 minutes.

#### Creating accounts

`POST /api/v1/accounts` can be called 5 times within 30 minutes.