> ## 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 one filing > Retrieve one filing by its id ## OpenAPI ````yaml GET /filings/{id} 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}: get: summary: Get one filing description: Retrieve one filing by its id operationId: getFiling parameters: - in: path name: id required: true schema: type: string description: The unique identifier of the transaction to fetch. responses: '200': description: Transaction fetch response content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/FilingsGet' message: type: string example: Successfully fetched filing. '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: FilingsGet: type: object properties: id: type: string description: The unique identifier for the filing. corporation_id: type: string description: The unique identifier for a corporation associated with this filing. form_title: type: string description: >- Name of the tax return form for this filing (e.g., "Sales and Use Tax Return"). description: type: string description: >- Additional details about the filing, such as filing variant or deadline type. country: $ref: '#/components/schemas/Country' country_specific_details: $ref: '#/components/schemas/CountrySpecificDetails' registration_tax_type_id: type: string nullable: true description: >- The V2 registration content identifier linking this filing to a specific registration tax type. Present for filings created via the V2 path; null for V1 filings. example: REG_STATE_CEN_06_RST jurisdiction_name: type: string nullable: true description: >- Human-readable jurisdiction name derived from V2 registration content (e.g., "California", "Germany"). Present for V2 filings; null for V1 filings. jurisdiction_type: type: string nullable: true description: >- Type of jurisdiction for this filing. Present for V2 filings; null for V1 filings. enum: - STATE_OR_PROVINCE - COUNTRY - TRADEBLOC - CITY_OR_COUNTY filing_content_id: type: string nullable: true description: >- Content identifier linking this filing to its filing calendar entry and contribution box rules. Present for V2 filings with content-driven calendars; null for V1 filings. example: FC_DE_3001_VAT frequency: $ref: '#/components/schemas/filing_frequency' period_start_date: type: string format: date description: >- ISO 8601 date string, identifying the start date of the period period for which the sales tax is being filed (e.g., '2024-09-01' for September 2024). For a quarter 1 filing where the fiscal year starts in March, the period_start_date will be 2024-03-01 and frequency will be QUARTERLY. reporting_period_start_date: type: string format: date description: >- Start date of the reporting period, which may differ from the tax period. reporting_period_end_date: type: string format: date description: End date of the reporting period. due_date: type: string format: date description: >- ISO 8601 date string, identifying the date when by which the filing must be submitted. filing_status: $ref: '#/components/schemas/Tax_filing_status' filed_on: type: string format: date description: Date when the taxes were filed with the state, in ISO 8601 format. registration_id: type: string description: >- The unique identifier for the tax registration associated with this filing. total_tax_filed: type: number description: >- Total amount of sales tax filed with various jurisdictions for this period. May differ slightly from the total tax collected. example: 135.92 sales_details: type: object properties: total_sales: type: number description: Total sales amount for the filing period. example: 12345.91 taxable_sales: type: number description: >- Total sales amount that was subject to sales tax for the filing period. example: 12345.91 sales_tax_collected: type: number description: Total sales tax collected during the period. example: 771.62 payment_details: type: object properties: amount_due: type: number description: Total amount due for this filing. example: 771.62 payment_status: type: string enum: - PENDING - COMPLETED - FAILED description: Status of the payment. failure_details: type: object description: >- This object will be populated if the payment fails for any reason. properties: failed_at: type: string description: >- ISO 8601 date string, identifying the date when the payment failed. reason: type: string description: Specific information why the payment failed. 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. Country: type: string example: US description: 'ISO 3166 2-letter country code. Ex: US, IN, GB.' CountrySpecificDetails: type: object properties: legal_name: type: string description: The legal name of the entity being registered. example: Example Inc. state: type: string description: State or province code. example: CA state_specific_details: type: object properties: payment_interval: type: string description: Payment interval for sales tax. sales_tax_id: type: string description: Sales tax ID. tax_types: type: array items: type: string filing_frequency: type: string enum: - MONTHLY - QUARTERLY - SEMI_ANNUALLY - ANNUAL_CALENDAR_YEAR - FISCAL_YEAR - MONTHLY_ACCELERATED_PREPAY_EARLY - QUARTERLY_PREPAY_MONTHLY - ANNUAL_RECONCILIATION - BI_MONTHLY - TRI_ANNUALLY - QUARTERLY_FEB - QUARTERLY_MAR description: >- How often the business is required to submit tax returns. V1 registrations typically use MONTHLY, QUARTERLY, SEMI_ANNUALLY, or ANNUAL_CALENDAR_YEAR. V2 registrations may use additional frequencies such as ANNUAL_RECONCILIATION (for jurisdictions requiring a separate annual reconciliation filing alongside periodic returns) or region-specific variants like QUARTERLY_FEB and QUARTERLY_MAR. Tax_filing_status: type: string enum: - SCHEDULED - ACCRUING - ACTIVE - FILED - OVERDUE description: >- Current status of the filing. SCHEDULED means the filing has been created but the tax period has not yet started. ACCRUING means transactions are being collected for this period. ACTIVE means the filing is ready for review and submission. FILED means the return has been submitted. OVERDUE means the due date has passed without filing. securitySchemes: bearerAuth: type: http scheme: bearer ````