---
title: "Status do serviço e da base"
method: GET
path: "/v1/status"
tags: ["Público"]
---

# Status do serviço e da base

`GET /v1/status`

## Request

- Base URL: `https://apipj.com.br`
- URL: `https://apipj.com.br/v1/status`
- Auth: none required

Informa se o serviço está no ar, o mês do lote da Receita Federal carregado e a quantidade de CNPJs. Aberta, sem chave e sem consumo de cota.

## Response `200`

Status do serviço

- Status
  - `status` 'OK' | 'DEGRADED', required: DEGRADED: base indisponível (a consulta responde 503)
  - `dataset_month` string, nullable, required: Mês do lote da Receita Federal (AAAA-MM)
  - `dataset_generated_at` string, date-time, nullable: Quando a base foi gerada (ISO 8601)
  - `rows` integer, nullable, required: Quantidade de CNPJs na base
  - `version` string, required: Versão da API
  - `time` string, date-time, required: Hora do servidor (ISO 8601)

## Other responses

- `429`: Limite de requisições por minuto por IP excedido (`rate_limited`)

---

[API](https://skmtc.dev/apipj/apis/apipj-api-de-cnpj.md) · [All operations](https://skmtc.dev/apipj/apis/apipj-api-de-cnpj/llms.txt) · [OpenAPI document](https://skmtc.dev/apipj/apis/apipj-api-de-cnpj/revisions/3896b833e2b5?raw)