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

# List filing contributions

> Retrieve the computed tax box values (contributions) for a specific filing. Each contribution represents a value that maps to a box on a tax return form, such as taxable sales or tax due. Contributions are ordered by box order, then by jurisdiction for multi-jurisdiction filings (e.g., EU OSS/IOSS).



## OpenAPI

````yaml GET /filings/{id}/contributions
openapi: 3.0.1
info:
  title: Commenda Public APIs
  description: >-
    APIs for Commenda entity management, partner incorporation, indirect tax,
    compliance, and corporate operations.
  license:
    name: NONE
    url: NONE
  version: 1.0.0
servers:
  - url: https://api.prod.commenda.io/api/v1
    description: Commenda platform APIs, including Partner Incorporation and Commenda OS.
  - url: https://transaction-tax.api.in.commenda.io/api/v1
    description: Global Indirect Tax API.
security:
  - bearerAuth: []
paths:
  /filings/{id}/contributions:
    get:
      summary: List filing contributions
      description: >-
        Retrieve the computed tax box values (contributions) for a specific
        filing. Each contribution represents a value that maps to a box on a tax
        return form, such as taxable sales or tax due. Contributions are ordered
        by box order, then by jurisdiction for multi-jurisdiction filings (e.g.,
        EU OSS/IOSS).
      operationId: listFilingContributions
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            format: uuid
          description: The unique identifier of the filing to retrieve contributions for.
      responses:
        '200':
          description: Filing contributions retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/FilingContributionsResponse'
                  message:
                    type: string
                    example: Successfully fetched filing contributions.
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Filing not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    FilingContributionsResponse:
      type: object
      properties:
        count:
          type: integer
          description: Total number of contributions returned.
          example: 5
        contributions:
          type: array
          items:
            $ref: '#/components/schemas/FilingContribution'
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              description: 'Specific Error type. Example: CLIENT_INVALID_REQUEST_BODY.'
              example: CLIENT_INVALID_REQUEST_BODY
            doc_url:
              type: string
              description: >-
                A link to the docs with details about this error. Example:
                https://sales-tax-docs.commenda.io/
              example: https://sales-tax-docs.commenda.io/
            title:
              type: string
              description: >-
                A short title describing the error. Example: Missing query
                parameters.
              example: Failed to validate the request body
            detail:
              type: string
              description: >-
                A json string with a description on how to fix the error.
                Example {"description":"Please pass in a valid corporation_id"}
            status:
              type: number
              description: >-
                The status code. It should be the same as the HTTP protocol
                status code. Example: 200
              example: 400
            instance:
              type: string
              description: >-
                The relative path that was hit by the user. Example:
                /api/v1/corporations/1
            Errors:
              type: array
              items:
                type: object
                properties:
                  details:
                    type: string
                    description: More details on how to solve this particular error.
                  pointer:
                    type: string
                    description: >-
                      Relative reference to missing or invalid piece of passed
                      information.
    FilingContribution:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for this contribution.
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        filing_id:
          type: string
          format: uuid
          description: The filing this contribution belongs to.
          example: f1e2d3c4-b5a6-7890-abcd-ef1234567890
        filing_contribution_id:
          type: string
          description: >-
            Stable content identifier that links this contribution to its tax
            return box rule definition.
          example: REG_COUNTRY_DE_3018_VAT_01_01
        filing_through_jurisdiction:
          type: string
          nullable: true
          description: >-
            Commenda jurisdiction identifier for the member state this
            contribution applies to. Present for multi-jurisdiction filings
            (e.g., EU OSS/IOSS); null for single-jurisdiction filings.
          example: COUNTRY_DE_3018
        value:
          type: integer
          format: int64
          description: >-
            The computed monetary amount in minor currency units (e.g., cents).
            For example, a value of 12345 represents 123.45 in the filing
            currency.
          example: 12345
        value_type:
          type: string
          description: The type of the value field. Currently always `INTEGER`.
          example: INTEGER
        box_id:
          type: string
          description: Identifier for the tax return form box this contribution maps to.
          example: DE_81
        box_name:
          type: string
          description: Human-readable name of the tax return form box.
          example: Steuerpflichtige Umsätze
        box_order:
          type: integer
          format: int32
          description: Display order of the box on the tax return form.
          example: 1
        box_type:
          type: string
          description: Classification of the box (e.g., input, output, total).
          example: OUTPUT
        created_at:
          type: integer
          format: int64
          description: Timestamp when this contribution was created, in Unix microseconds.
          example: 1713168000000000
        updated_at:
          type: integer
          format: int64
          description: >-
            Timestamp when this contribution was last updated, in Unix
            microseconds.
          example: 1713168000000000
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````