Sign in

v1

latestOpenAPI 3.1.02026-07-228956435.8 KB
Tax returns

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.

get/tax_returns/{id}

Path parameters

idstring required

The id of the tax return to retrieve.

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.

Response

The tax return.

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"
  }
}