> ## 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. # Get filing contributions (batch) > Multi-filing analog of `GET /filings/{id}/contributions`. Returns per-filing contribution boxes for a list of filing IDs (max 100). Each entry's `contributions` array is non-null for VAT filings (UK/EU country VAT and OSS/IOSS variants) — possibly empty if the engine has not computed boxes yet — and `null` for US and Canadian filings whose liability lives on the filing row itself. ## OpenAPI ````yaml POST /filings/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/contributions: post: tags: - Filings summary: Get filing contributions for a batch of filings description: >- Multi-filing analog of `GET /filings/{id}/contributions`. Returns per-filing contribution boxes for a list of filing IDs (max 100). Each entry's `contributions` array is non-null for VAT filings (UK/EU country VAT and OSS/IOSS variants) — possibly empty if the engine has not computed boxes yet — and `null` for US and Canadian filings whose liability lives on the filing row itself. operationId: getFilingContributionsBatch requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/GetFilingContributionsBatchRequest' responses: '200': description: Filing contributions retrieved successfully content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/GetFilingContributionsBatchResponse' message: type: string example: Successfully fetched filing contributions. '400': description: Bad request — invalid body or filing not found content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Caller is not authorized to access one or more filings content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: GetFilingContributionsBatchRequest: type: object required: - filing_ids properties: filing_ids: type: array description: >- List of filing UUIDs to fetch contributions for. Maximum 100 entries. minItems: 1 maxItems: 100 items: type: string format: uuid GetFilingContributionsBatchResponse: type: object properties: filings: type: array items: $ref: '#/components/schemas/FilingContributionsBatchEntry' 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. FilingContributionsBatchEntry: type: object description: >- One filing's slot in the batched contributions response. Common filing metadata is always populated. `contributions` is non-null for filings whose liability is computed from the filing contribution table (UK/EU VAT — country-level VATs and OSS variants); for US/Canada filings whose liability lives on the filing row itself, `contributions` is `null`. An empty array means "this is a contribution-type filing but the engine hasn't computed its boxes yet" — different from `null` ("does not apply"). properties: filing_id: type: string format: uuid example: f1e2d3c4-b5a6-7890-abcd-ef1234567890 form_title: type: string example: VAT Return jurisdiction: type: string example: Germany tax_period_start_date: type: string format: date example: '2025-01-01' tax_period_end_date: type: string format: date example: '2025-03-31' due_date: type: string format: date example: '2025-04-30' filing_status: type: string example: UPCOMING contributions: nullable: true type: array items: $ref: '#/components/schemas/FilingContribution' 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 ````