v1

latestOpenAPI 3.1.02026-07-228956435.8 KB

Tax statements

List tax statements

Returns a paginated list of the monthly tax statements (F29 form) of the fiscal account associated with a link, ordered by year and period with the most recent first. Use the link's link_token to authenticate the request. Available for Chilean links connected to the Chilean tax authority (SII).

get/tax_statements

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 statements per page. Defaults to 30. The maximum is 300.

pageinteger

Page number to retrieve. Starts at 1.

Response

Paginated list of the tax statements of the fiscal account, ordered by year and period with the most recent first. The Link and X-Total-Count headers carry the pagination information.

idstring required

Unique identifier of the tax statement.

object'tax_statement' required

Type of the object. Always tax_statement.

currencystring required

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

document_numberstring required

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

fiscal_yearinteger required

Fiscal year the tax statement corresponds to.

institution_idstring required

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

interval_unitstring required

Periodicity of the tax statement. Always monthly.

periodstring required

Month of fiscal_year the tax statement corresponds to, as a two-digit month number.

statusstring nullable required

Status of the declaration, as reported by the SII (for example, Vigente for a declaration currently in force). null when the SII does not report it.

Example response

[
  {
    "id": "taxstmt_nMNejK7BT8oGbvO4",
    "currency": "CLP",
    "document_number": "123456",
    "fiscal_year": 2021,
    "institution_id": "cl_fiscal_sii",
    "institution_tax_statement": {
      "monthly_provisional_payments": 120000,
      "retention_fee": 6497,
      "salary_tax": 1870153,
      "total_credit": 403497,
      "total_debit": 1173692,
      "total_payment": 2646845
    },
    "interval_unit": "monthly",
    "period": "10",
    "status": "Vigente",
    "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"
    }
  }
]