# Pontos de extremidade da API REST para limites de taxa

Use a API REST para verificar seu status de limite de taxa atual.

## Sobre limites de taxa

Você pode verificar seu status de limite de taxa atual a qualquer momento. Para obter mais informações sobre regras de limite de taxa, confira [Limites de taxa para a API REST](/pt/enterprise-server@3.18/rest/overview/rate-limits-for-the-rest-api).

A API REST para pesquisar itens tem um limite de taxa personalizado separado do limite de taxa que rege os outros pontos de extremidade da API REST. Para saber mais, confira [Endpoints da API REST para pesquisa](/pt/enterprise-server@3.18/rest/search/search). A API do GraphQL também tem um limite de taxa personalizado, separado e calculado de modo diferente dos limites de taxa na API REST. Para saber mais, confira [Limites de taxas e limites de consultas para a API GraphQL](/pt/enterprise-server@3.18/graphql/overview/resource-limitations#rate-limit). Por esses motivos, a resposta da API categoriza seu limite de taxa. Em `resources`, você verá objetos relacionados a diferentes categorias:

* O objeto `core` fornece o status de limite de taxa para todos os recursos não relacionados à pesquisa na API REST.

* O objeto `search` fornece seu status de limite de taxa para a API REST para pesquisa (excluindo as pesquisas de código). Para saber mais, confira [Endpoints da API REST para pesquisa](/pt/enterprise-server@3.18/rest/search/search).

* O objeto `code_search` fornece seu status de limite de taxa para a API REST para pesquisar o código. Para saber mais, confira [Endpoints da API REST para pesquisa](/pt/enterprise-server@3.18/rest/search/search#search-code).

* O objeto `graphql` fornece o status de limite de taxa para a API do GraphQL.

* O objeto `integration_manifest` fornece o status de limite de taxa para a operação do `POST /app-manifests/{code}/conversions`. Para saber mais, confira [Registrando um App do GitHub a partir de um manifesto](/pt/enterprise-server@3.18/apps/creating-github-apps/setting-up-a-github-app/creating-a-github-app-from-a-manifest#3-you-exchange-the-temporary-code-to-retrieve-the-app-configuration).

* O objeto `dependency_snapshots` fornece seu status de limite de taxa relativo ao envio de instantâneos para o grafo de dependência. Para saber mais, confira [Pontos de extremidade da API REST para o gráfico de dependência](/pt/enterprise-server@3.18/rest/dependency-graph).

* O objeto `code_scanning_upload` fornece o status de limite de taxa para carregar os resultados SARIF na verificação do código. Para saber mais, confira [Fazer o upload de arquivo SARIF para o GitHub](/pt/enterprise-server@3.18/code-security/code-scanning/integrating-with-code-scanning/uploading-a-sarif-file-to-github).

* O objeto `actions_runner_registration` fornece o status de limite da taxa para registrar os executores auto-hospedados em GitHub Actions. Para saber mais, confira [Pontos de extremidade da API REST para executores auto-hospedados](/pt/enterprise-server@3.18/rest/actions/self-hosted-runners).

Para obter mais informações sobre os cabeçalhos e os valores na resposta do limite de taxa, confira [Limites de taxa para a API REST](/pt/enterprise-server@3.18/rest/overview/rate-limits-for-the-rest-api).

> \[!NOTE]
> Most endpoints use `Authorization: Bearer <YOUR-TOKEN>` and `Accept: application/vnd.github+json` headers, plus `X-GitHub-Api-Version: 2022-11-28`. Curl examples below omit these standard headers for brevity.

## Get rate limit status for the authenticated user

```
GET /rate_limit
```

Note

Accessing this endpoint does not count against your REST API rate limit.

Some categories of endpoints have custom rate limits that are separate from the rate limit governing the other REST API endpoints. For this reason, the API response categorizes your rate limit. Under resources, you'll see objects relating to different categories:

The core object provides your rate limit status for all non-search-related resources in the REST API.
The search object provides your rate limit status for the REST API for searching (excluding code searches). For more information, see "Search."
The code\_search object provides your rate limit status for the REST API for searching code. For more information, see "Search code."
The graphql object provides your rate limit status for the GraphQL API. For more information, see "Resource limitations."
The integration\_manifest object provides your rate limit status for the POST /app-manifests/{code}/conversions operation. For more information, see "Creating a GitHub App from a manifest."
The dependency\_snapshots object provides your rate limit status for submitting snapshots to the dependency graph. For more information, see "Dependency graph."
The dependency\_sbom object provides your rate limit status for requesting SBOMs from the dependency graph. For more information, see "Dependency graph."
The actions\_runner\_registration object provides your rate limit status for registering self-hosted runners in GitHub Actions. For more information, see "Self-hosted runners."
The source\_import object is no longer in use for any API endpoints, and it will be removed in the next API version. For more information about API versions, see "API Versions."

Note

The rate object is closing down. If you're writing new API client code or updating existing code, you should use the core object instead of the rate object. The core object contains the same information that is present in the rate object.

### HTTP response status codes

* **200** - OK

* **304** - Not modified

* **404** - Resource not found

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/rate_limit
```

**Response schema (Status: 200):**

* `resources`: required, object:
  * `core`: required, `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `graphql`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `search`: required, `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `code_search`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `source_import`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `integration_manifest`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `actions_runner_registration`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `scim`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `dependency_sbom`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `code_scanning_autofix`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
  * `copilot_usage_records`: `Rate Limit`:
    * `limit`: required, integer
    * `remaining`: required, integer
    * `reset`: required, integer
    * `used`: required, integer
* `rate`: required, `Rate Limit`:
  * `limit`: required, integer
  * `remaining`: required, integer
  * `reset`: required, integer
  * `used`: required, integer