---
updatedAt: 2026-06-03T13:11:38.000Z
agentTools:
  projectIndex: https://docs.bankly.com.br/llms.txt
---

# Informe de rendimentos

<div class="bkly-ref-description">
Obtenha os dados necessários para gerar o Informe de Rendimentos de todos os seus clientes.
<span class="bkly-ref-small-deprecated-tag">deprecated</span>
<span class="bkly-ref-scope-tag">scope: income.report.read</span>
</div>
[block:callout]
  {
    "type": "warning",
    "title": "Importante",
    "body": "O _endpoint_ de Informe de rendimentos está disponível na [versão 2](https://docs.bankly.com.br/v2/reference/informe-rendimentos)."
  }
  [/block]


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Gestão de Contas",
    "description": "Abra e gerencie contas de pagamento do seu cliente pessoa física ou jurídica.",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api-mtls.sandbox.bankly.com.br"
    }
  ],
  "paths": {
    "/legal-agreements/file": {
      "get": {
        "tags": [
          "Acordos legais"
        ],
        "summary": "Obtenção do documento (acordo legal)",
        "description": "<div class=\"bkly-ref-description\">\n  <p>Obtenha o documento do acordo legal para ser visualizado e aceito pelo seu cliente.</p> \n  <span class=\"bkly-ref-small-beta-tag\">beta</span> \n  <span class=\"bkly-ref-scope-tag\">scope: legal.agreements.read</span>\n</div>\n
[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Nota\",\n  \"body\": \"Atualmente, este <i>endpoint</i> apenas retorna o documento de termos e condições de uso, que deve ser aplicado para cada conta individualmente. Para mais informações, confira a documentação [Obtenção do documento (acordo legal)](/docs/obtencao-do-documento).\"\n}\n[/block]
\n",
        "parameters": [
          {
            "name": "api-version",
            "in": "header",
            "description": "Versão da API.\nAtualmente estamos na **1.0**.\n",
            "required": true,
            "style": "simple",
            "explode": false,
            "schema": {
              "type": "string",
              "default": 1
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "style": "simple",
            "explode": false,
            "schema": {
              "type": "string",
              "description": "<i>Token</i> de autorização do tipo Bearer."
            }
          },
          {
            "name": "type",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "TERMS_AND_CONDITIONS_OF_USE",
              "description": "Tipo de acordo a ser obtido."
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Recurso encontrado.",
            "headers": {
              "x-bkly-correlation-id": {
                "description": "Id correlação da operação requisitada.",
                "style": "simple",
                "explode": false,
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/legalAgreementsGetResponse"
                }
              }
            }
          },
          "404": {
            "description": "Recurso não encontrado.\n",
            "headers": {
              "x-bkly-correlation-id": {
                "$ref": "#/paths/~1legal-agreements~1file/get/responses/200/headers/x-bkly-correlation-id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "accountDetailedExample": {
                    "value": {
                      "errors": [
                        {
                          "code": "SOME_ERROR_CODE",
                          "messages": [
                            "{{Some error message}}"
                          ]
                        }
                      ],
                      "reference": "link"
                    },
                    "summary": "Recurso não encontrado"
                  }
                }
              }
            }
          },
          "500": {
            "description": "Ocorreu algum erro inexperado em nosso servidor.\n",
            "headers": {
              "x-bkly-correlation-id": {
                "$ref": "#/paths/~1legal-agreements~1file/get/responses/200/headers/x-bkly-correlation-id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "accountDetailedExample": {
                    "value": {
                      "errors": [
                        {
                          "code": "SOME_ERROR_CODE",
                          "messages": [
                            "{{Some error message}}"
                          ]
                        }
                      ],
                      "reference": "link"
                    },
                    "summary": "Erro no servidor"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/accounts/{accountNumber}": {
      "get": {
        "tags": [
          "Consulta e encerramento"
        ],
        "summary": "Consulta de dados de uma conta",
        "description": "<div class=\"bkly-ref-description\">\n  <p>Realize a consulta dos dados de uma conta específica. Opcionalmente, é possível obter o saldo dessa conta (exceto o saldo bloqueado).</p> \n  <span class=\"bkly-ref-small-stable-tag\">stable</span> \n  <span class=\"bkly-ref-scope-tag\">scope: account.read</span>\n</div>\n
[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Nota\",\n  \"body\": \"Para mais informações, confira a documentação [Consulta de dados de uma conta](/docs/consulta-de-dados-de-uma-conta).\"\n}\n[/block]
\n",
        "operationId": "GetAccount",
        "parameters": [
          {
            "name": "accountNumber",
            "in": "path",
            "description": "Número da conta.\n",
            "required": true,
            "style": "simple",
            "explode": false,
            "schema": {
              "description": "Número da conta de pagamento.",
              "type": "string",
              "minLength": 3,
              "maxLength": 13
            }
          },
          {
            "$ref": "#/paths/~1legal-agreements~1file/get/parameters/0"
          },
          {
            "$ref": "#/components/parameters/IncludeBalance"
          },
          {
            "$ref": "#/paths/~1legal-agreements~1file/get/parameters/1"
          },
          {
            "name": "code",
            "in": "query",
            "schema": {
              "type": "string",
              "default": 332,
              "description": "Código do banco da conta consultada. Para conta corrente, este campo é <b>obrigatório</b>."
            }
          },
          {
            "name": "branch",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "Número da agência associada à conta consultada. Para conta corrente, este campo é <b>obrigatório</b>."
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Recurso encontrado.",
            "headers": {
              "x-bkly-correlation-id": {
                "$ref": "#/paths/~1legal-agreements~1file/get/responses/200/headers/x-bkly-correlation-id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountDetailedResponse"
                },
                "examples": {
                  "accountDetailedExample": {
                    "$ref": "#/components/examples/accountDetailedExample"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Há algum problema com a sua requisição.",
            "headers": {
              "x-bkly-correlation-id": {
                "$ref": "#/paths/~1legal-agreements~1file/get/responses/200/headers/x-bkly-correlation-id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "accountDetailedExample": {
                    "value": {
                      "errors": [
                        {
                          "code": "INVALID_PARAMETER",
                          "propertyName": "{{propertyName}}",
                          "messages": [
                            "{{\"propertyName\" error message}}"
                          ]
                        }
                      ],
                      "reference": "link"
                    },
                    "summary": "Parametro inválido"
                  }
                }
              }
            }
          },
          "403": {
            "$ref": "#/paths/~1pockets~1{pocketNumber}/get/responses/403"
          },
          "409": {
            "description": "A solicitação conflitou com o estado atual do recurso existente no servidor.\n",
            "headers": {
              "x-bkly-correlation-id": {
                "$ref": "#/paths/~1legal-agreements~1file/get/responses/200/headers/x-bkly-correlation-id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "accountDetailedExample": {
                    "value": {
                      "errors": [
                        {
                          "code": "SOME_ERROR_CODE",
                          "messages": [
                            "{{Some error message}}"
                          ]
                        }
                      ],
                      "reference": "link"
                    },
                    "summary": "Conflito entre regras de negócio"
                  }
                }
              }
            }
          },
          "422": {
            "description": "A sintaxe da requisição está correta, mas não foi possível processá-la devido a uma regra de negócio.\n",
            "headers": {
              "x-bkly-correlation-id": {
                "$ref": "#/paths/~1legal-agreements~1file/get/responses/200/headers/x-bkly-correlation-id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "accountDetailedExample": {
                    "value": {
                      "errors": [
                        {
                          "code": "SOME_ERROR_CODE",
                          "messages": [
                            "{{Some error message}}"
                          ]
                        }
                      ],
                      "reference": "link"
                    },
                    "summary": "Requisição incompatível com a regra de negócio"
                  }
                }
              }
            }
          },
          "500": {
            "$ref": "#/paths/~1legal-agreements~1file/get/responses/500"
          }
        }
      }
    },
    "/accounts/{accountNumber}/income-report": {
      "get": {
        "tags": [
          "Informe de Rendimentos"
        ],
        "summary": "Informe de rendimentos",
        "description": "<div class=\"bkly-ref-description\">\nObtenha os dados necessários para gerar o Informe de Rendimentos de todos os seus clientes.\n<span class=\"bkly-ref-small-deprecated-tag\">deprecated</span>\n<span class=\"bkly-ref-scope-tag\">scope: income.report.read</span>\n</div>\n
[block:callout]\n  {\n    \"type\": \"warning\",\n    \"title\": \"Importante\",\n    \"body\": \"O _endpoint_ de Informe de rendimentos está disponível na [versão 2](https://docs.bankly.com.br/v2/reference/informe-rendimentos).\"\n  }\n  [/block]
\n",
        "parameters": [
          {
            "name": "accountNumber",
            "in": "path",
            "description": "Número da conta da qual se deseja obter os dados para o informe.",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Número da conta.",
              "nullable": true
            }
          },
          {
            "name": "calendar",
            "in": "query",
            "description": "Ano para a geração das informações do informe de rendimento. O valor padrão será o ano atual da consulta menos um.",
            "schema": {
              "type": "integer",
              "description": "Ano para a geração das informações do informe de rendimento. O valor padrão será o ano atual da consulta menos um.",
              "format": "int32"
            }
          },
          {
            "$ref": "#/paths/~1legal-agreements~1file/get/parameters/0"
          },
          {
            "$ref": "#/paths/~1legal-agreements~1file/get/parameters/1"
          }
        ],
        "responses": {
          "200": {
            "description": "Recurso encontrado.",
            "headers": {
              "x-bkly-correlation-id": {
                "description": "Id correlação da operação requisitada.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetIncomeReportResponse"
                }
              }
            }
          },
          "204": {
            "description": "Recurso encontrado, mas não existe conteúdo na sua requisição.",
            "headers": {
              "x-bkly-correlation-id": {
                "description": "Id correlação da operação requisitada.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "$ref": "#/paths/~1accounts~1{accountNumber}/get/responses/400"
          },
          "404": {
            "$ref": "#/paths/~1legal-agreements~1file/get/responses/404"
          },
          "500": {
            "$ref": "#/paths/~1legal-agreements~1file/get/responses/500"
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    }
  },
  "security": [
    {
      "Bearer": []
    }
  ],
  "components": {
    "schemas": {
      "PayerSource": {
        "type": "object",
        "description": "Objeto que contém informações sobre a fonte pagadora.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Razão social da fonte pagadora."
          },
          "documentNumber": {
            "type": "string",
            "description": "Número do documento CNPJ da fonte pagadora."
          }
        }
      },
      "NetIncomeV1": {
        "type": "object",
        "description": "Objeto que contém informações sobre os rendimentos líquidos do cliente.",
        "properties": {
          "amount": {
            "type": "number",
            "description": "Valor do rendimento líquido."
          },
          "currency": {
            "type": "string",
            "description": "Sigla da moeda do valor do rendimento de acordo com a ISO 4207."
          }
        }
      },
      "IncomeReportResponse": {
        "type": "object",
        "properties": {
          "payerSource": {
            "$ref": "#/components/schemas/PayerSource"
          },
          "holder": {
            "$ref": "#/components/schemas/Holder"
          },
          "account": {
            "$ref": "#/components/schemas/Account"
          },
          "balances": {
            "$ref": "#/components/schemas/IncomeBalance"
          },
          "netIncome": {
            "$ref": "#/components/schemas/NetIncomeV1"
          }
        },
        "additionalProperties": false
      },
      "GetIncomeReportResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/IncomeReportResponse"
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Link"
            },
            "nullable": true,
            "readOnly": true
          },
          "metadata": {
            "type": "object",
            "description": "Metadados da requisição.",
            "additionalProperties": {
              "type": "object",
              "additionalProperties": false
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "Link": {
        "type": "object",
        "description": "Links de próximos estados válidos da entidade/recurso.",
        "properties": {
          "url": {
            "type": "string",
            "nullable": true,
            "description": "URLs que podem ser utilizadas em um próximo estado da entidade. Nesse caso, trata-se da própria requisição realizada."
          },
          "rel": {
            "type": "string",
            "nullable": true,
            "description": "Descrição de como a URL se relaciona com o recurso atual."
          },
          "method": {
            "type": "string",
            "nullable": true,
            "description": "Tipo de verbo que deve ser utilizado para acessar a URL. Nesse caso, é o GET."
          }
        },
        "additionalProperties": false
      },
      "Error": {
        "description": "Detalhes do erro identificado.",
        "type": "object",
        "properties": {
          "errors": {
            "description": "Lista de erros identificados. Trate-os antes de tentar novamente.",
            "type": "array",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          },
          "reference": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "code": {
            "description": "Código do erro.",
            "type": "string",
            "nullable": true
          },
          "propertyName": {
            "description": "Parâmetro ou propriedade com problema. Somente será retornado quando o erro for de sintaxe (Bad Request).",
            "type": "string",
            "nullable": true
          },
          "message": {
            "description": "Lista de descrições do problema encontrado.",
            "type": "array",
            "nullable": true,
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "Account": {
        "type": "object",
        "properties": {
          "branch": {
            "type": "string",
            "nullable": true,
            "description": "Número da agência bancária."
          },
          "number": {
            "type": "string",
            "nullable": true,
            "description": "Número da conta."
          }
        },
        "additionalProperties": false
      },
      "IncomeBalance": {
        "type": "array",
        "description": "Lista de objetos que contém informações sobre o saldo do ano vigente (ou do ano enviado no campo <code>calendar</code>) e o saldo do ano anterior.",
        "items": {
          "type": "object",
          "properties": {
            "year": {
              "type": "string",
              "description": "Ano do saldo.",
              "nullable": true
            },
            "amount": {
              "type": "number",
              "format": "double",
              "description": "Valor referente ao saldo da conta."
            },
            "currency": {
              "type": "string",
              "nullable": true,
              "description": "Sigla da moeda do saldo de acordo com a ISO 4207."
            }
          },
          "additionalProperties": false
        }
      },
      "Holder": {
        "type": "object",
        "description": "Objeto que contém informações sobre o titular da conta.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Nome do titular.",
            "nullable": true
          },
          "documentNumber": {
            "type": "string",
            "description": "Número do documento do titular.",
            "nullable": true
          }
        },
        "additionalProperties": false
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "http",
        "description": "Inclua um token de autorização do tipo Bearer.",
        "scheme": "bearer"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true,
    "samples-enabled": true,
    "samples-languages": [
      "curl"
    ]
  }
}
```