> ## 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 Portafolios

> Usa este endpoint para recuperar los detalles de todos los Portafolios en tu Ledger. Si los filtros en la solicitud no cumplen con los criterios del endpoint, se devolverá una respuesta vacía.



## OpenAPI

````yaml es/openapi/v3-current/ledger.yaml get /v1/organizations/{organization_id}/ledgers/{ledger_id}/portfolios
openapi: 3.1.0
info:
  title: API de Midaz Ledger
  version: 4.0.0
servers:
  - url: /
security: []
tags:
  - name: Tipos de cuenta (v1)
  - name: Tipos de cuenta (v2)
  - name: Cuentas (v1)
  - name: Cuentas (v2)
  - name: Tasas de activos (v1)
  - name: Activos (v1)
  - name: Activos (v2)
  - name: Saldos (v1)
  - name: Saldos (v2)
  - name: Cálculo de facturación (v2)
  - name: Paquetes de facturación (v2)
  - name: Composición (v2)
  - name: Cifrado (v2)
  - name: Comisiones (v2)
  - name: Titulares (v2)
  - name: Instrumentos (v2)
  - name: Ledgers (v1)
  - name: Ledgers (v2)
  - name: Índices de metadatos (v1)
  - name: Índices de metadatos (v2)
  - name: Rutas de operaciones (v1)
  - name: Rutas de operaciones (v2)
  - name: Operaciones (v1)
  - name: Operaciones (v2)
  - name: Organizaciones (v1)
  - name: Organizaciones (v2)
  - name: Paquetes (v2)
  - name: Carteras (v1)
  - name: Carteras (v2)
  - name: Protección (v2)
  - name: Segmentos (v1)
  - name: Segmentos (v2)
  - name: Rutas de transacciones (v1)
  - name: Rutas de transacciones (v2)
  - name: Transacciones (v1)
  - name: Transacciones (v2)
paths:
  /v1/organizations/{organization_id}/ledgers/{ledger_id}/portfolios:
    get:
      tags:
        - Carteras (v1)
      summary: Listar Portafolios
      description: >-
        Usa este endpoint para recuperar los detalles de todos los Portafolios
        en tu Ledger. Si los filtros en la solicitud no cumplen con los
        criterios del endpoint, se devolverá una respuesta vacía.
      operationId: listPortfolios
      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/json:
              schema:
                $ref: '#/components/schemas/LegacyError'
          description: Error
      deprecated: true
      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
    LegacyError:
      additionalProperties: false
      properties:
        code:
          description: >-
            Stable, machine-readable midaz error code. Identical to the code /v2
            returns for the same condition.
          examples:
            - '0065'
          type: string
        entityType:
          description: >-
            The domain entity the error concerns. Present only on
            field-validation errors.
          examples:
            - Account
          type: string
        fields:
          additionalProperties: {}
          description: >-
            Per-field validation detail, keyed by field name. The value is the
            violation message for a known field and the offending value for an
            unexpected one, so it is not always a string. The /v2 contract
            carries these as the 'errors' array.
          type: object
        message:
          description: >-
            Human-readable explanation of this occurrence. The /v2 contract
            carries this as 'detail'.
          type: string
        title:
          description: Short, human-readable summary of the error.
          examples:
            - Invalid Path Parameter
          type: string
      required:
        - title
        - message
        - code
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      description: JWT bearer token issued by the identity provider.
      scheme: bearer
      type: http

````