> ## 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 Portfólios > Use este endpoint para consultar os detalhes de todos os Portfólios no seu Ledger. Se os filtros na requisição não atenderem aos critérios do endpoint, uma resposta vazia será retornada. ## OpenAPI ````yaml pt/openapi/v3-current/ledger.yaml get /v2/organizations/{organization_id}/ledgers/{ledger_id}/portfolios openapi: 3.1.0 info: title: API Midaz Ledger version: 4.0.0 servers: - url: / security: [] tags: - name: Tipos de conta (v1) - name: Tipos de conta (v2) - name: Contas (v1) - name: Contas (v2) - name: Taxas de ativos (v1) - name: Ativos (v1) - name: Ativos (v2) - name: Saldos (v1) - name: Saldos (v2) - name: Cálculo de cobrança (v2) - name: Pacotes de cobrança (v2) - name: Composição (v2) - name: Criptografia (v2) - name: Taxas (v2) - name: Titulares (v2) - name: Instrumentos (v2) - name: Ledgers (v1) - name: Ledgers (v2) - name: Índices de metadados (v1) - name: Índices de metadados (v2) - name: Rotas de operação (v1) - name: Rotas de operação (v2) - name: Operações (v1) - name: Operações (v2) - name: Organizações (v1) - name: Organizações (v2) - name: Pacotes (v2) - name: Portfólios (v1) - name: Portfólios (v2) - name: Proteção (v2) - name: Segmentos (v1) - name: Segmentos (v2) - name: Rotas de transação (v1) - name: Rotas de transação (v2) - name: Transações (v1) - name: Transações (v2) paths: /v2/organizations/{organization_id}/ledgers/{ledger_id}/portfolios: get: tags: - Portfólios (v2) summary: Listar Portfólios description: >- Use este endpoint para consultar os detalhes de todos os Portfólios no seu Ledger. Se os filtros na requisição não atenderem aos critérios do endpoint, uma resposta vazia será retornada. operationId: listPortfoliosV2 parameters: - description: Organization ID (UUID) in: path name: organization_id required: true schema: description: Organization ID (UUID) type: string - description: Ledger ID (UUID) in: path name: ledger_id required: true schema: description: Ledger ID (UUID) type: string - description: JSON string to filter portfolios by metadata fields explode: false in: query name: metadata schema: description: JSON string to filter portfolios by metadata fields type: string - description: Filter portfolios by entity ID explode: false in: query name: entity_id schema: description: Filter portfolios by entity ID type: string - description: Filter portfolios by status explode: false in: query name: status schema: description: Filter portfolios by status type: string - description: Max items per page (1-100, default 10) explode: false in: query name: limit schema: description: Max items per page (1-100, default 10) type: string - description: Page number (default 1) explode: false in: query name: page schema: description: Page number (default 1) type: string - description: Filter portfolios created on/after this date (YYYY-MM-DD) explode: false in: query name: start_date schema: description: Filter portfolios created on/after this date (YYYY-MM-DD) type: string - description: Filter portfolios created on/before this date (YYYY-MM-DD) explode: false in: query name: end_date schema: description: Filter portfolios created on/before this date (YYYY-MM-DD) type: string - description: Sort direction (asc, desc) explode: false in: query name: sort_order schema: description: Sort direction (asc, desc) type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/Pagination' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Error' description: Error security: - BearerAuth: [] components: schemas: Pagination: additionalProperties: false properties: items: {} limit: examples: - 10 format: int64 type: integer next_cursor: examples: - eyJpZCI6IjAxOTI... type: string page: examples: - 1 format: int64 type: integer prev_cursor: examples: - eyJpZCI6IjAxOTE... type: string required: - items - limit type: object Error: additionalProperties: false properties: code: description: >- Stable, machine-readable domain error code scoped to the emitting service (format: -NNNN). examples: - ERR-0001 type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string upstream: $ref: '#/components/schemas/Upstream' description: >- RFC 9457 extension member: the error a proxied third-party provider reported. Absent unless the emitting service explicitly surfaced one. type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object Upstream: additionalProperties: false properties: code: description: The upstream provider's own error code, verbatim. examples: - E4001 type: string message: description: >- The upstream provider's own error message, verbatim (bounded, never its raw response body). examples: - account not found at provider type: string type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT bearer token issued by the identity provider. scheme: bearer type: http ````