v1

latestOpenAPI 3.1.02026-07-228956435.8 KB

Tax returns

List tax returns

Returns a paginated list of the annual tax returns (F22 form) of the fiscal account associated with a link. Use the link's link_token to authenticate the request. Available for Chilean links connected to the Chilean tax authority (SII).

get/tax_returns

Query parameters

link_tokenstring required

Example:link_Q0xVGPvijElLRMwE_token_FhsFVurz5q5FycHA5xxhTpzX

The link_token of the link that holds the fiscal account, returned when you exchange the link.

per_pageinteger

Number of tax returns per page. Defaults to 30. The maximum is 300.

pageinteger

Page number to retrieve. Starts at 1.

Response

Paginated list of the tax returns of the fiscal account. The Link and X-Total-Count headers carry the pagination information.

idstring required

Unique identifier of the tax return.

object'tax_return' required

Type of the object. Always tax_return.

currencystring required

Three-letter ISO 4217 currency code of the amounts in the tax return. Always CLP.

document_numberstring required

Folio number of the declaration at the Chilean tax authority (SII).

fiscal_yearinteger required

Fiscal year the tax return corresponds to.

institution_idstring required

ID of the fiscal authority that received the declaration. Always cl_fiscal_sii.

Example response

[
  {
    "id": "taxret_nMNejK7BT8oGbvO4",
    "currency": "CLP",
    "document_number": "12345",
    "fiscal_year": 2021,
    "institution_id": "cl_fiscal_sii",
    "institution_tax_return": {
      "income": {
        "fees": 5700000,
        "fees_with_retention": 4500000,
        "fees_without_retention": 1200000,
        "salary": 12000000,
        "withheld_fees": 562500
      },
      "refund_account": {
        "holder_id": "111111111",
        "holder_name": "Jon Snow",
        "institution": {
          "id": "cl_banco_de_chile",
          "country": "cl",
          "name": "Banco de Chile"
        },
        "number": 9530516286
      },
      "refund_amount": 350000
    },
    "taxpayer": {
      "id": "111111111",
      "institution_tax_payer": {
        "activities": [
          {
            "category": "1",
            "code": "620200",
            "description": "Servicios de tecnología",
            "started_at": "2020-04-16T04:00:00.000Z"
          }
        ],
        "addresses": [
          {
            "apartment": "1204",
            "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",
        "phone": "999999999"
      },
      "name": "Fintoc SpA"
    }
  }
]