IntroduçãoReferência de APICentral de AjudaObter SuporteStatus page
Referência

🧭 Introdução à API

Confira uma breve introdução das APIs da iugu.

A iugu oferece uma interface de programação web no modelo REST, permitindo interação eficiente com seu sistema. Com essa API, você pode executar comandos, verificar configurações e sincronizar dados com seus próprios sistemas.

A comunicação é feita através do endereço base https://api.iugu.com, utilizando sempre o protocolo seguro https://. As versões da API são organizadas em diretórios específicos, sufixados ao endereço base (por exemplo, https://api.iugu.com/v1.

Postman Collection

Além das referências em dev.iugu.com/referece, disponibilizamos uma Collection do Postman:

Abrir no Postman

Atualizado em 23/05/25

Notas de atualização

Novo parâmetro

Rota: Consultar Envio de Documentos para Verificação de Conta iugu

  • status — Permite filtrar pelos status pending_manual_analysis, accepted ou requested.

Rota: Enviar Verificação de Subconta

Novos parâmetros

  • street, number, complement e estimated_revenue

Em breve removido

  • address

Autenticação

A autenticação na iugu é realizada por meio de uma chave de API, que permite ao sistema identificar a sua conta e conceder as permissões necessárias para a comunicação com a iugu em nome da conta associada. Saiba mais.

Produção e Teste

A distinção de um ambiente de produção ou teste será feita através do api_token que for utilizado no momento da requisição. Crie um api_token e utilize de acordo com com sua necessidade.

🚧

Importante

O endpoint de test está sujeito a um limite de uso de 50 requisições por minuto. Requisições que excederem esse limite receberão uma resposta com o código HTTP 429 - Too Many Requests.

Recomendamos o uso de Mocks em testes automatizados para evitar restrições e garantir maior controle em seus fluxos de validação. Saiba mais.

Limite de 1000 faturas test por dia

A rota Criar Fatura — POST /v1/invoice tem um limite de até 1000 faturas por dia. Essa medida tem como principal objetivo manter a estabilidade dos nossos serviços.

IP de saída da iugu

Para aqueles que fazem controle dos IPs em seu Firewall, por exemplo, considere permitir o 54.207.210.151.

Tabela de Erros

Disponibilizamos também uma tabela dos principais erros e seus motivos para consulta neste link.

Recipes

Acesse a nossa biblioteca de Recipes. Um jeito prático e dinâmico de como utilizar as nossas APIs para determinados objetivos.

Paginação

Para APIs de listagem, são utilizados parâmetros de paginação. Saiba mais.

Atualizações

Sempre que uma nova feature ou atualização acontece, informamos os detalhes em nossa Página de Atualizações.

Status da iugu

Tenha acesso ao status dos serviços da iugu em tempo real em status.iugu.com.

Obter suporte

Se precisar de ajuda técnica, entre em contato com o nosso Suporte Técnico.