> ## 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.

# 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).

**`v1`** · Base URL `https://api.fintoc.com/v1`


## OpenAPI

````yaml reference/fintoc-api.json GET /tax_statements
openapi: 3.1.0
info:
  title: fintoc-api
  version: v2026-02-01
servers:
  - url: https://api.fintoc.com/v1
security: []
paths:
  /tax_statements:
    get:
      tags:
        - Tax statements
      summary: List tax statements
      description: >-
        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).
      operationId: tax-statements-list
      parameters:
        - 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.
        - name: per_page
          in: query
          required: false
          schema:
            type: integer
            format: int32
          description: >-
            Number of tax statements per page. Defaults to `30`. The maximum is
            `300`.
        - name: page
          in: query
          required: false
          schema:
            type: integer
            format: int32
          description: Page number to retrieve. Starts at `1`.
      responses:
        '200':
          description: >-
            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.
          headers:
            Link:
              schema:
                type: string
            X-Total-Count:
              schema:
                type: integer
          content:
            application/json:
              examples:
                tax_statements_list:
                  value:
                    - id: taxstmt_nMNejK7BT8oGbvO4
                      object: tax_statement
                      currency: CLP
                      document_number: '123456'
                      fiscal_year: 2021
                      institution_id: cl_fiscal_sii
                      institution_tax_statement:
                        monthly_provisional_payments: null
                        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
                              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:
                type: array
                items:
                  $ref: '#/components/schemas/tax_statement'
        '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'
      security:
        - api_key: []
components:
  schemas:
    tax_statement:
      type: object
      description: >-
        Monthly tax declaration (F29 form) the taxpayer filed with the Chilean
        tax authority (SII) for a period.
      properties:
        id:
          type: string
          description: Unique identifier of the tax statement.
          example: taxstmt_nMNejK7BT8oGbvO4
        object:
          const: tax_statement
          description: Type of the object. Always `tax_statement`.
        currency:
          type: string
          description: >-
            Three-letter ISO 4217 currency code of the amounts in the tax
            statement. Always `CLP`.
          example: CLP
        document_number:
          type: string
          description: Folio number of the declaration at the Chilean tax authority (SII).
          example: '123456'
        fiscal_year:
          type: integer
          description: Fiscal year the tax statement 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_statement:
          $ref: '#/components/schemas/institution_tax_statement'
        interval_unit:
          type: string
          description: Periodicity of the tax statement. Always `monthly`.
          example: monthly
        period:
          type: string
          description: >-
            Month of `fiscal_year` the tax statement corresponds to, as a
            two-digit month number.
          example: '10'
        status:
          type:
            - string
            - 'null'
          description: >-
            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: Vigente
        taxpayer:
          $ref: '#/components/schemas/taxpayer'
      required:
        - id
        - object
        - currency
        - document_number
        - fiscal_year
        - institution_id
        - institution_tax_statement
        - interval_unit
        - period
        - status
        - 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_statement:
      type: object
      description: >-
        Amounts the taxpayer declared in the F29 form for the period. Every
        amount is in Chilean pesos (CLP has no decimals); `null` when the
        declaration does not include the corresponding value.
      properties:
        monthly_provisional_payments:
          type:
            - integer
            - 'null'
          description: Monthly provisional payments (PPM) declared for the period.
          example: 120000
        retention_fee:
          type:
            - integer
            - 'null'
          description: >-
            Tax withheld from professional fee receipts (boletas de honorarios)
            for the period.
          example: 6497
        salary_tax:
          type:
            - integer
            - 'null'
          description: Second category tax over salaries declared for the period.
          example: 1870153
        total_credit:
          type:
            - integer
            - 'null'
          description: Total credits declared for the period.
          example: 403497
        total_debit:
          type:
            - integer
            - 'null'
          description: Total debits declared for the period.
          example: 1173692
        total_payment:
          type:
            - integer
            - 'null'
          description: Total tax to pay within the legal term for the period.
          example: 2646845
      required:
        - monthly_provisional_payments
        - retention_fee
        - salary_tax
        - total_credit
        - total_debit
        - total_payment
    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
    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

````