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

# List credit note items



## OpenAPI

````yaml /.tooling/schemas/rest/tags/product-finops.json get /finops/v1/payable-credit-notes/{credit_note_id}/line-items
openapi: 3.1.0
info:
  title: Tesouro Partner API
  version: '2026-09-24'
  description: The Tesouro REST API, for Tesouro partners to integrate with our solution.
  termsOfService: https://tesouro.com/terms
  contact:
    name: Tesouro team
    url: https://tesouro.com/about/
    email: developers@tesouro.com
servers:
  - url: https://api.sandbox.tesouro.com
    description: Sandbox
security: []
tags:
  - name: Accounting connections
  - name: Accounting data pull
  - name: Accounting synchronized records
  - name: Accounting tax rates
  - name: Analytics
  - name: Approval policies
  - name: Approval requests
  - name: Bank details
  - name: Comments
  - name: Cost centers
  - name: Counterpart addresses
  - name: Counterpart bank accounts
  - name: Counterpart contacts
  - name: Counterpart VAT IDs
  - name: Counterparts
  - name: Credit notes
  - name: Custom tax rates
  - name: Delivery notes
  - name: Departments
  - name: Disclosures
  - name: Documents
  - name: Events
  - name: Files
  - name: Ledger accounts
  - name: Locations
  - name: Mail templates
  - name: Mailbox domains
  - name: Mailboxes
  - name: Measure units
  - name: OCR
  - name: OIDC applications
  - name: Organizations
  - name: Overdue reminders
  - name: Payable duplicates
  - name: Payable line items
  - name: Payables
  - name: Payment intents
  - name: Payment links
  - name: Payment methods
  - name: Payment records
  - name: Payment reminders
  - name: Payment terms
  - name: PDF templates
  - name: Products
  - name: Projects
  - name: Purchase orders
  - name: Receipts
  - name: Receivables
  - name: Recurrences
  - name: Roles
  - name: Tags
  - name: Text templates
  - name: Transactions
  - name: Users
  - name: Webhook deliveries
  - name: Webhook subscriptions
paths:
  /finops/v1/payable-credit-notes/{credit_note_id}/line-items:
    get:
      tags:
        - Credit notes
      summary: List credit note items
      operationId: get_payable-credit-notes_id_line-items
      parameters:
        - required: true
          schema:
            type: string
            format: date
          example: '2026-09-24'
          name: x-finops-version
          in: header
        - name: credit_note_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: order
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/OrderEnum'
            default: asc
          description: >-
            Sort order (ascending by default). Typically used together with the
            `sort` parameter.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            default: 100
          description: >-
            The number of items (0 .. 100) to return in a single page of the
            response. The response may contain fewer items if it is the last or
            only page.
        - name: pagination_token
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
          description: >-
            A pagination token obtained from a previous call to this endpoint.
            Use it to get the next or previous page of results for your initial
            query. If `pagination_token` is specified, all other query
            parameters are ignored and inferred from the initial query.


            If not specified, the first page of results will be returned.
        - name: sort
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/CreditNoteLineItemCursorFields'
              - type: 'null'
          description: >-
            The field to sort the results by. Typically used together with the
            `order` parameter.
        - name: created_at__gt
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
        - name: created_at__lt
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
        - name: created_at__gte
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
        - name: created_at__lte
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
        - name: name
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
        - name: name__iexact
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
        - name: name__contains
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
        - name: name__icontains
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
        - name: description
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
        - name: description__contains
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
        - name: description__icontains
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
        - name: total__gt
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: total__lt
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: total__gte
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: total__lte
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: subtotal__gt
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: subtotal__lt
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: subtotal__gte
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: subtotal__lte
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: unit_price__gt
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: unit_price__lt
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: unit_price__gte
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: unit_price__lte
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: quantity__gt
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                minimum: 0
              - type: 'null'
        - name: quantity__lt
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                minimum: 0
              - type: 'null'
        - name: quantity__gte
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                minimum: 0
              - type: 'null'
        - name: quantity__lte
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                minimum: 0
              - type: 'null'
        - name: tax__gt
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: tax__lt
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: tax__gte
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: tax__lte
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: tax_amount__gt
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: tax_amount__lt
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: tax_amount__gte
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: tax_amount__lte
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 0
              - type: 'null'
        - name: created_by_user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
        - name: unit
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
        - name: unit__iexact
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
        - name: source
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
        - name: source_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
        - name: x-organization-id
          in: header
          required: true
          schema:
            type: string
            format: uuid
            examples:
              - 9d2b4c8f-2087-4738-ba91-7359683c49a4
          description: The ID of the entity that owns the requested resource.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreditNoteLineItemPaginationResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorSchemaResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorSchemaResponse'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorSchemaResponse'
        '405':
          description: Method Not Allowed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorSchemaResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorSchemaResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    OrderEnum:
      type: string
      enum:
        - asc
        - desc
    CreditNoteLineItemCursorFields:
      type: string
      enum:
        - id
        - created_at
        - name
        - total
        - quantity
        - unit_price
    CreditNoteLineItemPaginationResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/CreditNoteLineItemResponse'
          type: array
          description: List of credit note line items for the current page
        next_pagination_token:
          anyOf:
            - type: string
            - type: 'null'
          description: Token to retrieve the next page of results
          examples:
            - eyJwYWdlIjoyfQ==
        prev_pagination_token:
          anyOf:
            - type: string
            - type: 'null'
          description: Token to retrieve the previous page of results
          examples:
            - eyJwYWdlIjoxfQ==
      additionalProperties: false
      type: object
      required:
        - data
      description: A paginated list of credit note line items.
    ErrorSchemaResponse:
      properties:
        error:
          $ref: '#/components/schemas/ErrorSchema'
      type: object
      required:
        - error
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    CreditNoteLineItemResponse:
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier of the line item
          examples:
            - 123e4567-e89b-12d3-a456-426614174000
        created_at:
          type: string
          format: date-time
          description: Timestamp when the line item was created
          examples:
            - '2024-01-15T14:30:00Z'
        updated_at:
          type: string
          format: date-time
          description: Timestamp when the line item was last updated
          examples:
            - '2024-01-15T14:30:00Z'
        created_by_user_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          description: ID of the user who created the line item
          examples:
            - 123e4567-e89b-12d3-a456-426614174000
        credit_note_id:
          type: string
          format: uuid
          description: ID of the parent credit note
          examples:
            - 123e4567-e89b-12d3-a456-426614174000
        description:
          anyOf:
            - type: string
            - type: 'null'
          description: Detailed description of the line item
          examples:
            - Premium version of Product XYZ with extended warranty
        name:
          anyOf:
            - type: string
            - type: 'null'
          description: Name or title of the line item
          examples:
            - Product XYZ
        quantity:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
          description: Quantity of items
          examples:
            - 2
        subtotal:
          anyOf:
            - type: integer
            - type: 'null'
          description: Subtotal amount before tax
          examples:
            - 10000
        tax:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          description: Tax percentage
          examples:
            - 20
        tax_amount:
          anyOf:
            - type: integer
            - type: 'null'
          description: Tax amount
          examples:
            - 2000
        total:
          anyOf:
            - type: integer
            - type: 'null'
          description: Total amount including tax
          examples:
            - 12000
        unit:
          anyOf:
            - type: string
            - type: 'null'
          description: Unit of measurement
          examples:
            - pieces
        unit_price:
          anyOf:
            - type: integer
            - type: 'null'
          description: Price per unit in smallest currency unit
          examples:
            - 5000
      additionalProperties: false
      type: object
      required:
        - id
        - created_at
        - updated_at
        - credit_note_id
      description: >-
        Schema for credit note line item response. Includes all fields that can
        be returned from the API.
    ErrorSchema:
      properties:
        message:
          type: string
      type: object
      required:
        - message
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
      type: object
      required:
        - loc
        - msg
        - type
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````