> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Listar Operações por Conta > Use este endpoint para consultar todas as Operações de uma Conta específica. ## OpenAPI ````yaml pt/openapi/v3-current/ledger.yaml get /v1/organizations/{organization_id}/ledgers/{ledger_id}/accounts/{account_id}/operations openapi: 3.1.0 info: title: API Midaz Ledger description: >- Referência completa da API para serviços do Midaz Ledger incluindo gerenciamento de organizações, operações de ledger, ativos, segmentos, portfolios, contas, tipos de conta, transações, operações, saldos, rotas de operação, rotas de transação e índices de metadata. version: 3.7.8 servers: - url: https://ledger.sandbox.lerian.net security: [] tags: - name: API de Organizações - name: API de Ledgers - name: API de Ativos - name: API de Segmentos - name: API de Portfolios - name: API de Tipos de Conta - name: API de Contas - name: API de Saldos - name: API de Transações - name: API de Operações - name: API de Rotas de Operação - name: API de Rotas de Transação - name: API de Índices de Metadata - name: API de Titulares - name: API de Instrumentos - name: API de Pacotes de Cobrança - name: API de Pacotes - name: API de Cálculo de Cobrança - name: API de Estimativa - name: API de Criptografia - name: API de Proteção - name: API de Taxas de Ativos paths: /v1/organizations/{organization_id}/ledgers/{ledger_id}/accounts/{account_id}/operations: get: tags: - API de Operações summary: Listar Operações por Conta description: >- Use este endpoint para consultar todas as Operações de uma Conta específica. parameters: - $ref: '#/components/parameters/OrganizationId' - $ref: '#/components/parameters/LedgerId' - $ref: '#/components/parameters/ContentType' - $ref: '#/components/parameters/AccountId' - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/Authorization' - name: limit in: query description: O número máximo de itens a incluir na resposta. required: false example: 10 schema: type: integer default: 10 minimum: 1 maximum: 100 - name: start_date in: query description: >- O início do período que você deseja consultar. start_date e end_date são tudo-ou-nada: fornecer apenas um retorna 400. Se ambos forem omitidos, é usada uma janela padrão do último 1 mês. required: false example: '2021-01-01' schema: type: string - name: end_date in: query description: >- O fim do período que você deseja consultar. start_date e end_date são tudo-ou-nada: fornecer apenas um retorna 400. Se ambos forem omitidos, é usada uma janela padrão do último 1 mês. required: false example: '2025-01-01' schema: type: string - name: sort_order in: query description: A ordem utilizada para classificar os resultados. required: false example: asc schema: type: string default: asc enum: - asc - desc - name: cursor in: query description: >- Um token de cursor codificado de uma resposta anterior (next_cursor ou prev_cursor) para navegar para frente ou para trás nos resultados. required: false example: >- eyJpZCI6IjAxOTNiNTZmLWJhY2YtNzQ0MS05NDU4LTEyZTE5MjVlOGI4NCIsInBvaW50c19uZXh0Ijp0cnVlfQ== schema: type: string - name: type in: query description: O tipo de operação. required: false example: DEBIT schema: type: string enum: - CREDIT - DEBIT - ON_HOLD - RELEASE - OVERDRAFT - BLOCK - UNBLOCK - name: direction in: query description: Filtra operações por direção na contabilidade de partida dobrada. required: false example: debit schema: type: string enum: - debit - credit - name: route_id in: query description: Filtra operações pelo ID da rota de operação. required: false example: 019c96a0-1071-7a0d-9916-a831221de252 schema: type: string format: uuid - name: route_code in: query description: Filtra operações pelo código da rota de operação. required: false example: PIX-DEBIT schema: type: string responses: '200': description: >- Indica que a requisição foi bem-sucedida e a resposta contém os dados esperados. content: application/json: schema: type: object properties: items: type: array items: $ref: '#/components/schemas/GetOperationResponse' next_cursor: type: string description: >- Cursor codificado apontando para a próxima página de resultados. prev_cursor: type: string description: >- Cursor codificado apontando para a página anterior de resultados. limit: type: integer description: O número máximo de itens incluídos na resposta. '400': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: Error0082: $ref: '#/components/examples/Error0082' Error0081: $ref: '#/components/examples/Error0081' Error0080: $ref: '#/components/examples/Error0080' headers: {} '401': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: Error0041: $ref: '#/components/examples/Error0041' Error0042: $ref: '#/components/examples/Error0042' '403': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: Error0043: $ref: '#/components/examples/Error0043' '404': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: Error0052: $ref: '#/components/examples/Error0052' Error0069: $ref: '#/components/examples/Error0069' '500': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: Error0046: $ref: '#/components/examples/Error0046' components: parameters: OrganizationId: name: organization_id in: path description: O identificador único da Organização associada ao Ledger. required: true example: 019c96a0-0a98-7287-9a31-786e0809c769 schema: type: string format: uuid LedgerId: name: ledger_id in: path description: O identificador único do Ledger associado. required: true example: 019c96a0-0ac0-7de9-9f53-9cf842a2ee5a schema: type: string format: uuid ContentType: name: Content-Type in: header description: O tipo de mídia do recurso. O valor recomendado é `application/json`. required: false example: application/json schema: type: string AccountId: name: account_id in: path description: O identificador único da conta. required: true example: 019c96a0-0c0c-7221-8cf3-13313fb60081 schema: type: string format: uuid XRequestId: name: X-Request-Id in: header description: >- Um identificador único utilizado para rastrear e acompanhar cada requisição. required: false example: 019c96a0-0a98-7287-9a31-786e0809c769 schema: type: string format: uuid Authorization: name: Authorization in: header required: false schema: type: string description: > Token JWT bearer para autenticação. Obrigatório quando `PLUGIN_AUTH_ENABLED=true` (exigido em implantações multi-tenant). Opcional no modo OSS single-tenant padrão. Formato: `Bearer ` schemas: GetOperationResponse: type: object properties: id: type: string description: O identificador único da Operação. format: uuid transactionId: type: string format: uuid description: O identificador único da Transação. organizationId: type: string format: uuid description: O identificador único da Organização. ledgerId: type: string description: O identificador único do Ledger. format: uuid accountId: type: string description: O identificador único da Conta. format: uuid accountAlias: type: string description: O alias da conta utilizada na operação. balanceId: type: string description: O identificador único do Saldo. balanceKey: type: string description: A chave única que identifica o Saldo. description: type: string description: Descrição da transação. type: type: string description: >- O tipo da operação. `OVERDRAFT` identifica operações companion geradas pelo sistema no saldo interno `"overdraft"` — `direction` carrega então a semântica do ciclo de vida (`debit` para um draw, `credit` para um reembolso). `BLOCK` e `UNBLOCK` identificam operações produzidas pelos endpoints de transação de block/unblock; `direction` continua carregando a semântica de débito/crédito. enum: - CREDIT - DEBIT - ON_HOLD - RELEASE - OVERDRAFT - BLOCK - UNBLOCK assetCode: type: string description: O nome do ativo utilizado na operação. chartOfAccounts: type: string description: O nome do Plano de Contas ao qual a operação pertence. route: type: string deprecated: true description: >- **Obsoleto.** Use `routeId` no lugar. Será removido na próxima versão major. routeId: type: string format: uuid description: >- O identificador único da rota de operação associada a esta operação. Operações companion de overdraft herdam esse valor da operação primária que as gerou. routeCode: type: string maxLength: 100 description: >- Um código legível da rota de operação, útil para auditoria e rastreabilidade. routeDescription: type: string description: A descrição da rota de operação associada a esta operação. direction: type: string enum: - debit - credit description: A direção da operação na contabilidade de partida dobrada. amount: type: object description: Um objeto contendo informações sobre o valor utilizado na operação. properties: value: type: string description: O valor que será enviado. balance: type: object description: Um objeto contendo informações sobre o saldo antes da operação. properties: available: type: string description: Saldo disponível anterior. onHold: type: string description: Valor retido/reservado. version: type: integer description: Versão do saldo, que é atualizada a cada transação. overdraftUsed: type: string description: >- O overdraft consumido por este saldo antes da operação, como string decimal. `"0"` para operações que não tocam o overdraft. balanceAfter: type: object description: Um objeto contendo informações sobre o saldo após a operação. properties: available: type: string description: Saldo disponível atual. onHold: type: string description: Valor retido/reservado. version: type: integer description: Versão do saldo, que é atualizada a cada transação. overdraftUsed: type: string description: >- O overdraft consumido por este saldo após a operação, como string decimal. `"0"` para operações que não tocam o overdraft. status: type: object description: O status da transação (pendente, concluída, revertida). properties: code: type: string description: Código de status da transação. description: type: string description: Descrição do status da transação. nullable: true balanceAffected: type: boolean description: Se verdadeiro, indica que a operação afetou o saldo da conta. createdAt: type: string format: date-time description: Data e hora de criação (UTC). updatedAt: type: string format: date-time description: Data e hora da última atualização (UTC). deletedAt: type: string format: date-time description: Data e hora da exclusão lógica, se aplicável (UTC). nullable: true metadata: $ref: '#/components/schemas/Metadata' ErrorFormat: type: object description: A mensagem de erro da resposta. required: - code - title - message properties: code: type: string description: Um identificador único e estável para o erro. title: type: string description: Um breve resumo do problema. message: type: string description: Orientação detalhada para resolver o erro. entityType: type: string description: >- O tipo de entidade ao qual o erro se refere (por exemplo, organization, ledger, account, transaction). Opcional. fields: type: object additionalProperties: true description: Informações adicionais sobre os campos que causaram o erro. Metadata: type: object additionalProperties: oneOf: - type: string maxLength: 2000 - type: number - type: boolean description: >- Um objeto contendo pares de chave-valor para adicionar como metadata, onde o campo `name` é a chave e o campo `value` é o valor. Por exemplo, para adicionar um Centro de Custo, use `'costCenter': 'BR_11101997'`. **Restrições:** as chaves devem ter no máximo 100 caracteres; valores de string no máximo 2000 caracteres. Objetos aninhados não são permitidos (os valores devem ser string, número ou booleano), a estrutura não pode exceder uma profundidade máxima de 10, e é permitido um máximo de 100 chaves. examples: Error0082: value: code: '0082' title: Invalid Query Parameter message: >- One or more query parameters are in an incorrect format. Please check the following parameters '{{parameter}}' and ensure they meet the required format before trying again. summary: Invalid Query Parameter Error0081: value: code: '0081' title: Invalid Sort Order message: >- The 'sort_order' field must be 'asc' or 'desc'. Please provide a valid sort order and try again. summary: Invalid Sort Order Error0080: value: code: '0080' title: Pagination Limit Exceeded message: >- The pagination limit exceeds the maximum allowed of {{pageLimit}} items per page. Please verify the limit and try again. summary: Pagination Limit Exceeded Error0041: summary: Token Missing value: code: '0041' title: Token Missing message: >- A valid token must be provided in the request header. Please include a token and try again. Error0042: summary: Invalid Token value: code: '0042' title: Invalid Token message: >- The provided token is expired, invalid or malformed. Please provide a valid token and try again. Error0043: summary: Insufficient Privileges value: code: '0043' title: Insufficient Privileges message: >- You do not have the necessary permissions to perform this action. Please contact your administrator if you believe this is an error. Error0052: value: code: '0052' title: Account ID Not Found message: >- The provided account ID does not exist in our records. Please verify the account ID and try again. summary: Account ID Not Found Error0069: value: code: '0069' title: No Operations Found message: >- No operations were found for the given query parameters. Please adjust your filters and try again. summary: No Operations Found Error0046: summary: Internal Server Error value: code: '0046' title: Internal Server Error message: >- The server encountered an unexpected error. Please try again later or contact support. ````