Códigos HTTP das respostas

Nossa API utiliza respostas HTTP convencionais para indicar sucesso ou falha nas requisições. Respostas com status 200 indicam sucesso, status 4xx indicam falhas decorrentes de erros nas informações enviadas, e status 500 indicam erros internos em nosso servidor.

Código HTTPDescrição
200 OKSua requisição foi bem sucedida.
400 Bad RequestAlgum parâmetro obrigatório não foi enviado ou é inválido. Neste caso a própria resposta indicará qual é o problema.
401 UnauthorizedNão foi enviada API Key ou ela é inválida.
404 Not FoundO endpoint ou o objeto solicitado não existe.
403 ForbiddenRequisição não autorizada. Abuso da API ou uso de parâmetros não permitidos podem gerar este código.
403 Forbidden / Cloudfront (GET)Erros 403 em chamadas GET indicam que você está enviando um body junto da requisição. Você não deve enviar nenhuma informação no body em chamadas do tipo GET.
429 Too Many RequestsMuitos pedidos em um determinado período de tempo. Mais em nossa seção sobre Rate Limiting.
500 Internal Server ErrorAlgo deu errado no servidor do Asaas.

Todos os endpoints da API recebem e respondem em JSON.

Exemplo de resposta para HTTP 400:

{
    "errors":[
        {
            "code":"invalid_value",
            "description":"O campo value deve ser informado"
        },
        {
            "code":"invalid_dueDate",
            "description":"A data de vencimento não pode ser inferior à hoje"
        }
    ]
}