Pular para conteúdo
Documentação oficial

API GOB

Acesso somente leitura a 40 entidades fiscais e contábeis, autenticado por API Key. Simples, previsível e seguro.

Começar agora Referência interativa

O que é a API GOB

A API GOB oferece acesso programático somente leitura (GET) às entidades de dados fiscais e contábeis da plataforma GOB Soluções. Todas as requisições são autenticadas por uma API Key enviada no cabeçalho X-Api-Key.

Chave de acesso

A chave de API é fornecida pelo suporte e deve ser enviada em todas as requisições. Sem ela, a resposta será 401 Unauthorized.

  •   Autenticação por API Key

    Um único cabeçalho X-Api-Key protege todos os endpoints. Saiba como obter e enviar a sua chave.

    Autenticação

  •   Consultas flexíveis

    Pagine, ordene, selecione campos e combine filtros complexos usando searchParams (JSON codificado na URL).

    Como consultar

  •   Filtros poderosos

    Mais de 40 operadores where — de equals e contains a filtros de data e arrays.

    Filtros e operadores

  •   40 entidades

    Clientes, certidões, parcelamentos, procurações, situação fiscal e muito mais.

    Entidades disponíveis

Em resumo
Host integracao.gob.com.br
Protocolo HTTPS
Base path /
Autenticação API Key no cabeçalho X-Api-Key
Formato application/json
Operações Somente leitura (GET)
Entidades 40 disponíveis para consulta

Primeira requisição

Uma consulta mínima a uma entidade — por exemplo, Account (Cliente):

curl -i -H "X-Api-Key: SUA_CHAVE_AQUI" \
  "https://integracao.gob.com.br/api/v1/Account"

curl.exe -i -H "X-Api-Key: SUA_CHAVE_AQUI" `
  "https://integracao.gob.com.br/api/v1/Account"

A forma recomendada de filtrar é com searchParams, um JSON codificado na URL:

const searchParams = {
  maxSize: 50,
  offset: 0,
  select: ["modifiedAt", "name", "sicCode"],
  orderBy: "modifiedAt",
  order: "desc",
  where: [{ type: "startsWith", attribute: "sicCode", value: "123" }]
};

const url = `https://integracao.gob.com.br/api/v1/Account?searchParams=${encodeURIComponent(JSON.stringify(searchParams))}`;

Ver o guia completo de consultas