> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trio.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# List Card Invoice Lines

> List lines for a specific Card Invoice



## OpenAPI

````yaml v2/api-reference/openapi.json GET /v2/cards/invoices/{id}/lines
openapi: 3.0.0
info:
  title: Trio API v2
  version: 2026-10-19.v2
servers:
  - url: https://api.sandbox.trio.com.br
    variables: {}
  - url: https://api.qa.trio.com.br
    variables: {}
  - url: https://api.trio.com.br
    variables: {}
security: []
tags: []
paths:
  /v2/cards/invoices/{id}/lines:
    parameters:
      - description: >-
          Version of the v2 contract the client is written against. Each
          breaking change publishes a new version.
        example: 2026-10-19.v2
        in: header
        name: Trio-Version
        required: true
        schema:
          enum:
            - 2026-10-19.v2
          type: string
          x-struct: null
          x-validate: null
      - description: >-
          ID of another org to act on instead of the API key's own org. The
          key's org must have been granted access to it, and the request is
          refused with 403 FORBIDDEN otherwise. When that access or the API key
          is read-only, only GET and HEAD requests may carry it. When the target
          org requires mTLS, so does the request. Leave it out to act on the
          key's own org.
        in: header
        name: Trio-Target-Org-Id
        required: false
        schema:
          format: uuid
          type: string
          x-struct: null
          x-validate: null
    get:
      tags:
        - Cards
      summary: List Card Invoice Lines
      description: List lines for a specific Card Invoice
      operationId: TrioFoundationWeb.V2.Card.InvoiceController.list_lines
      parameters:
        - description: Invoice ID
          in: path
          name: id
          required: true
          schema:
            $ref: '#/components/schemas/UUID'
        - description: Entity ID
          in: query
          name: entity_id
          required: true
          schema:
            $ref: '#/components/schemas/UUID'
        - description: >-
            Parameter used for pagination. It is a base64 encoded param used to
            access the previous page of results. It is provided alongside a
            metadata section if there is a previous page.
          example: >-
            g3QAAAABZAACaWRtAAAAJDU4ZjFlYzhlLWFmYTktNDk0My05M2I1LWQ2ZGM3OWI0M2VhYQ==
          in: query
          name: before
          required: false
          schema:
            type: string
            x-struct: null
            x-validate: null
        - description: >-
            Parameter used for pagination. It's a base64 encoded param used to
            access the previous page of results. Provided along with the data in
            the metadata section if there is a previous page.
          example: >-
            g3QAAAABZAACaWRtAAAAJGJhYTNiNmM1LTAyYTYtNGQ5Ny05NzU1LTI3OGFiNjRiN2Y1MQ==
          in: query
          name: after
          required: false
          schema:
            type: string
            x-struct: null
            x-validate: null
        - description: Parameter used for pagination.
          in: query
          name: limit
          required: false
          schema:
            type: integer
            x-struct: null
            x-validate: null
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_list_card_invoice_lines_response'
          description: Invoice Lines
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: >-
            Malformed request: a body that is not valid JSON
            (MALFORMED_REQUEST), or a Trio-Version header that is missing or not
            the current one (INVALID_TRIO_VERSION).
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: Missing or invalid API key credentials (INVALID_CREDENTIALS).
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: >-
            The API key may not do this (FORBIDDEN): for instance
            Trio-Target-Org-Id names an org it has no access to, or writes
            through a read-only access.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: No resource with this ID (NOT_FOUND_RESOURCE).
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: >-
            Invalid input (INVALID_PARAMETER, REQUIRED_PARAMETER, or the code of
            the rule the request breaks). A request outside the operation's
            schema lists the offending fields in `errors`.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: >-
            A service needed to answer is unavailable
            (TRIO_SERVICE_UNAVAILABLE).
      callbacks: {}
      security:
        - authorization: []
components:
  schemas:
    UUID:
      description: Unique identifier
      format: uuid
      title: UUID
      type: string
      x-struct: null
      x-validate: null
    V2_list_card_invoice_lines_response:
      description: A page of card invoice lines
      example:
        data:
          - amount:
              amount: 10000
              currency: BRL
            card_id: 0182b3d1-0b3b-4b3b-8b3b-0b3b4b3b8b3b
            card_number: •••• •••• •••• 1234
            id: 0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b
            invoice_id: 0182b3d2-0b3b-4b3b-8b3b-0b3b4b3b8b3b
            line_category: streaming
            line_status: confirmed
            line_title: Streaming service
            occurred_at: '2025-06-20T03:05:00.000000Z'
            ref_id: 0182b3d3-0b3b-4b3b-8b3b-0b3b4b3b8b3b
            ref_type: purchase
        metadata:
          after: null
          before: null
          has_more: false
      properties:
        data:
          items:
            $ref: '#/components/schemas/V2_card_invoice_line'
          type: array
          x-struct: null
          x-validate: null
        metadata:
          $ref: '#/components/schemas/V2_card_list_metadata'
      required:
        - data
        - metadata
      title: V2 list card invoice lines response
      type: object
      x-struct: >-
        Elixir.TrioFoundationWeb.Schemas.Banking.V2.Card.Invoice.ListLineResponse
      x-validate: null
    V2_error:
      example:
        error:
          error_code: INVALID_PARAMETER
          error_message: 'Invalid parameters: /amount: Invalid integer. Got: string'
          errors:
            - field: /amount
              message: 'Invalid integer. Got: string'
      properties:
        error:
          properties:
            error_code:
              description: >-
                Stable UPPER_SNAKE identifier of the error, for programs and
                logs. Branch on this, not on the message.
              type: string
              x-struct: null
              x-validate: null
            error_message:
              description: Human readable explanation of the error.
              type: string
              x-struct: null
              x-validate: null
            errors:
              description: >-
                Only on INVALID_PARAMETER for a request outside the operation's
                schema: one entry per offending field.
              items:
                properties:
                  field:
                    description: JSON pointer to the field, e.g. /amount.
                    type: string
                    x-struct: null
                    x-validate: null
                  message:
                    description: What is wrong with it.
                    type: string
                    x-struct: null
                    x-validate: null
                required:
                  - field
                  - message
                type: object
                x-struct: null
                x-validate: null
              type: array
              x-struct: null
              x-validate: null
          required:
            - error_code
            - error_message
          type: object
          x-struct: null
          x-validate: null
      required:
        - error
      title: V2 error
      type: object
      x-struct: Elixir.TrioFoundationWeb.Schemas.HTTP.V2Error
      x-validate: null
    V2_card_invoice_line:
      description: One movement of a card invoice
      example:
        amount:
          amount: 10000
          currency: BRL
        card_id: 0182b3d1-0b3b-4b3b-8b3b-0b3b4b3b8b3b
        card_number: •••• •••• •••• 1234
        id: 0182b3d0-0b3b-4b3b-8b3b-0b3b4b3b8b3b
        invoice_id: 0182b3d2-0b3b-4b3b-8b3b-0b3b4b3b8b3b
        line_category: streaming
        line_status: confirmed
        line_title: Streaming service
        occurred_at: '2025-06-20T03:05:00.000000Z'
        ref_id: 0182b3d3-0b3b-4b3b-8b3b-0b3b4b3b8b3b
        ref_type: purchase
      properties:
        amount:
          $ref: '#/components/schemas/V2_card_money'
        card_id:
          description: Card ID
          format: uuid
          type: string
          x-struct: null
          x-validate: null
        card_number:
          description: Masked card number
          type: string
          x-struct: null
          x-validate: null
        id:
          description: Line ID
          format: uuid
          type: string
          x-struct: null
          x-validate: null
        invoice_id:
          description: Invoice ID
          format: uuid
          type: string
          x-struct: null
          x-validate: null
        line_category:
          description: Line category
          type: string
          x-struct: null
          x-validate: null
        line_status:
          description: Line status
          enum:
            - reversed
            - confirmed
            - voided
          type: string
          x-struct: null
          x-validate: null
        line_title:
          description: Line title
          type: string
          x-struct: null
          x-validate: null
        occurred_at:
          description: When the movement happened
          format: date-time
          type: string
          x-struct: null
          x-validate: null
        ref_id:
          description: ID of the purchase, top up or transfer the line comes from
          format: uuid
          type: string
          x-struct: null
          x-validate: null
        ref_type:
          description: What the line comes from
          enum:
            - purchase
            - topup
            - transfer_in
            - transfer_out
          type: string
          x-struct: null
          x-validate: null
      title: V2 card invoice line
      type: object
      x-struct: Elixir.TrioFoundationWeb.Schemas.Banking.V2.Card.Invoice.LineData
      x-validate: null
    V2_card_list_metadata:
      description: Pagination cursors
      example:
        after: null
        before: null
        has_more: false
      properties:
        after:
          description: Cursor to the next page
          nullable: true
          type: string
          x-struct: null
          x-validate: null
        before:
          description: Cursor to the previous page
          nullable: true
          type: string
          x-struct: null
          x-validate: null
        has_more:
          description: Whether a next page exists
          type: boolean
          x-struct: null
          x-validate: null
      required:
        - after
        - before
        - has_more
      title: V2 card list metadata
      type: object
      x-struct: Elixir.TrioFoundationWeb.Schemas.Banking.V2.Card.ListMetadata
      x-validate: null
    V2_card_money:
      description: An amount of money in cents. It can be zero or negative.
      example:
        amount: 10000
        currency: BRL
      properties:
        amount:
          description: Amount in cents
          type: integer
          x-struct: null
          x-validate: null
        currency:
          description: Currency
          enum:
            - BRL
          type: string
          x-struct: null
          x-validate: null
      required:
        - amount
        - currency
      title: V2 card money
      type: object
      x-struct: Elixir.TrioFoundationWeb.Schemas.Banking.V2.Card.Money
      x-validate: null
  securitySchemes:
    authorization:
      scheme: basic
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.