> ## Documentation Index > Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a tax return > Retrieves a tax return by its `id`, using the link's `link_token` to authenticate the request. You can only retrieve tax returns that belong to the link's fiscal account. **`v1`** · Base URL `https://api.fintoc.com/v1` ## OpenAPI ````yaml reference/fintoc-api.json GET /tax_returns/{id} openapi: 3.1.0 info: title: fintoc-api version: v2026-02-01 servers: - url: https://api.fintoc.com/v1 security: [] paths: /tax_returns/{id}: get: tags: - Tax returns summary: Get a tax return description: >- Retrieves a tax return by its `id`, using the link's `link_token` to authenticate the request. You can only retrieve tax returns that belong to the link's fiscal account. operationId: tax-returns-get parameters: - name: id in: path description: The `id` of the tax return to retrieve. required: true schema: type: string - name: link_token in: query required: true schema: type: string example: link_Q0xVGPvijElLRMwE_token_FhsFVurz5q5FycHA5xxhTpzX description: >- The `link_token` of the link that holds the fiscal account, returned when you exchange the link. responses: '200': description: The tax return. content: application/json: examples: tax_return: value: id: taxret_nMNejK7BT8oGbvO4 object: tax_return currency: CLP document_number: '12345' fiscal_year: 2021 institution_id: cl_fiscal_sii institution_tax_return: due_amount: 0 income: fees: 5700000 fees_with_retention: 4500000 fees_without_retention: 1200000 salary: 12000000 withheld_fees: 562500 refund_account: holder_id: '111111111' holder_name: Fintoc SpA institution: id: cl_banco_de_chile country: cl name: Banco de Chile number: 123123123 refund_amount: 350000 taxpayer: id: '111111111' institution_tax_payer: activities: - category: '1' code: '620200' description: Servicios de tecnología iva: false started_at: '2020-04-16T04:00:00.000Z' addresses: - apartment: null city: Santiago code: '84345463' commune: PROVIDENCIA number: '2461' region: REGION METROPOLITANA street: LOS CONQUISTADORES authorized_documents: - authorized_at: '2021-11-30T15:57:38.584Z' code: '33' description: FACTURA ELECTRONICA max_documents: 414 email: hello@fintoc.com institution_office: null phone: '999999999' name: Fintoc SpA schema: $ref: '#/components/schemas/tax_return' '400': description: 'Invalid request: the `link_token` is missing or empty.' content: application/json: examples: empty_link_token: value: error: type: invalid_request_error code: empty_string param: link_token message: 'Empty string is invalid: link_token' doc_url: https://docs.fintoc.com/reference/errors schema: $ref: '#/components/schemas/error_object' '401': description: Invalid or missing API key. content: application/json: examples: invalid_api_key: value: error: type: authentication_error code: invalid_api_key message: 'Invalid API Key: invalid-*oken' schema: $ref: '#/components/schemas/error_object' '403': description: >- The `link_token` is invalid or belongs to a different mode than the API key. content: application/json: examples: invalid_link_token: value: error: type: invalid_request_error code: invalid_link_token param: link_token message: >- Invalid access token for link: link_nMNejK7BT8oGbvO4_token_**** doc_url: https://docs.fintoc.com/reference/errors schema: $ref: '#/components/schemas/error_object' '404': description: >- The tax return does not exist or does not belong to the link's fiscal account. content: application/json: examples: tax_return_not_found: value: error: type: invalid_request_error code: missing_resource param: id message: 'No such tax_return: taxret_nMNejK7BT8oGbvO4' doc_url: https://docs.fintoc.com/reference/errors schema: $ref: '#/components/schemas/error_object' security: - api_key: [] components: schemas: tax_return: type: object description: >- Annual income tax return (F22 form) the taxpayer filed with the Chilean tax authority (SII) for a fiscal year. properties: id: type: string description: Unique identifier of the tax return. example: taxret_nMNejK7BT8oGbvO4 object: const: tax_return description: Type of the object. Always `tax_return`. currency: type: string description: >- Three-letter ISO 4217 currency code of the amounts in the tax return. Always `CLP`. example: CLP document_number: type: string description: Folio number of the declaration at the Chilean tax authority (SII). example: '12345' fiscal_year: type: integer description: Fiscal year the tax return corresponds to. example: 2021 institution_id: type: string description: >- ID of the fiscal authority that received the declaration. Always `cl_fiscal_sii`. example: cl_fiscal_sii institution_tax_return: $ref: '#/components/schemas/institution_tax_return' taxpayer: $ref: '#/components/schemas/taxpayer' required: - id - object - currency - document_number - fiscal_year - institution_id - institution_tax_return - taxpayer error_object: type: object properties: error: type: object description: Details of the error that caused the request to fail. properties: code: type: string description: >- Machine-readable code identifying the specific error, for example `invalid_api_key`. Not returned by every error. example: invalid_api_key doc_url: type: string description: >- URL of a documentation page with more details about the error. Not returned by every error. example: https://docs.fintoc.com/reference/errors message: type: string description: Human-readable message describing the error. example: 'Invalid API Key: invalid-*oken' param: type: - string - 'null' description: >- Name of the request parameter that caused the error. `null` when the error cannot be tied to a single parameter, and not returned by every error. example: amount type: type: string description: >- Category of the error, for example `invalid_request_error`, `authentication_error`, or `api_error`. example: invalid_request_error required: - type - message institution_tax_return: type: object description: >- Figures of the tax return the taxpayer filed for the fiscal year, as reported by the Chilean tax authority (SII). properties: due_amount: type: integer description: >- Tax left to pay to the Chilean tax authority (SII) for the fiscal year, in Chilean pesos (CLP has no decimals). Always `0`. example: 0 income: type: object description: >- Income the taxpayer declared in the F22 form for the fiscal year. Every amount is in Chilean pesos (CLP has no decimals); `null` when the declaration does not include the corresponding code. properties: fees: type: - integer - 'null' description: >- Total income from professional fee receipts (boletas de honorarios), the sum of `fees_with_retention` and `fees_without_retention`. Code 547 of the F22 form. example: 5700000 fees_with_retention: type: - integer - 'null' description: >- Income from professional fee receipts with tax withheld by the payer. Code 461 of the F22 form. example: 4500000 fees_without_retention: type: - integer - 'null' description: >- Income from professional fee receipts without tax withheld. Code 545 of the F22 form. example: 1200000 salary: type: - integer - 'null' description: >- Income from salaries, pensions, and similar sources. Code 1098 of the F22 form. example: 12000000 withheld_fees: type: - integer - 'null' description: >- Total tax withheld from professional fee receipts. Code 492 of the F22 form. example: 562500 required: - fees - fees_with_retention - fees_without_retention - salary - withheld_fees refund_account: type: - object - 'null' properties: holder_id: type: - string - 'null' description: >- Tax identifier of the counterpart account holder, without dots or hyphens (RUT in Chile, RFC in Mexico). example: '111111111' holder_name: type: - string - 'null' description: >- Name of the counterpart account holder, as registered at the institution. example: Jon Snow institution: anyOf: - $ref: '#/components/schemas/institution' - type: 'null' description: >- Institution of the counterpart account. `null` when Fintoc cannot identify the institution. number: type: - integer - 'null' description: Number of the counterpart account. example: 9530516286 required: - holder_id - holder_name - number - institution refund_amount: type: - integer - 'null' description: >- Refund the taxpayer requested from the SII for the fiscal year, in Chilean pesos (CLP has no decimals). example: 350000 required: - due_amount - income - refund_account - refund_amount taxpayer: type: object description: >- Taxpayer the declaration belongs to, identified by a Chilean tax ID (RUT). properties: id: type: string description: Chilean tax ID (RUT) of the taxpayer, without dots or hyphens. example: '111111111' institution_tax_payer: type: object description: >- Information about the taxpayer, as registered at the Chilean tax authority (SII). properties: activities: type: array description: Economic activities of the taxpayer registered at the SII. items: $ref: '#/components/schemas/activity' addresses: type: array description: Addresses of the taxpayer registered at the SII. items: $ref: '#/components/schemas/address' authorized_documents: type: array description: Tax document types the SII authorizes the taxpayer to issue. items: type: object properties: authorized_at: type: string format: date-time description: >- ISO 8601 timestamp of when the SII authorized the document type. example: '2021-11-30T15:57:38.584Z' code: type: string description: SII code of the document type. example: '33' description: type: string description: Name of the document type. example: FACTURA ELECTRONICA max_documents: type: integer description: >- Maximum number of folios the SII authorizes for the document type. example: 414 email: type: string description: Email of the taxpayer registered at the SII. example: hello@fintoc.com institution_office: type: - object - 'null' description: >- SII office where the taxpayer is registered, as an opaque object whose fields the SII defines. `null` when the SII does not report it. phone: type: string description: Phone number of the taxpayer registered at the SII. example: '999999999' required: - activities - addresses - authorized_documents - email - institution_office - phone name: type: string description: Name of the taxpayer. For companies, the legal name. example: Fintoc SpA required: - id - institution_tax_payer - name institution: type: object properties: id: type: string description: Unique identifier of the institution. example: cl_banco_de_chile country: type: string description: ISO 3166-1 alpha-2 code of the country of the institution. example: cl name: type: string description: Name of the institution. example: Banco de Chile required: - id - country - name activity: type: object properties: category: type: string description: >- Tax category of the activity: `1` for first category (business income) or `2` for second category (income from professional services). example: '1' code: type: string description: >- Code of the economic activity, as classified by the Chilean tax authority (SII). example: '620200' description: type: string description: Description of the economic activity. example: Servicios de tecnología iva: type: boolean description: Whether the activity is subject to value-added tax (IVA). example: false started_at: type: string format: date-time description: >- ISO 8601 timestamp of when the taxpayer started the activity at the SII. example: '2020-04-16T04:00:00.000Z' address: type: object properties: apartment: type: - string - 'null' description: >- Apartment or office number. `null` when the address does not include one. example: '1204' city: type: string description: City of the address. example: Santiago code: type: string description: Branch code of the address at the Chilean tax authority (SII). example: '84345463' commune: type: string description: Commune of the address. example: PROVIDENCIA number: type: string description: Street number of the address. example: '2461' region: type: string description: Region of the address. example: REGION METROPOLITANA street: type: string description: Street of the address. example: LOS CONQUISTADORES securitySchemes: api_key: type: apiKey name: Authorization in: header ````