Retrieve tax statuses for a link

Retrieve tax status information for a specific fiscal link.

omitstring

Omit certain fields from being returned in the response. For more information, see our <a href="https://developers.belvo.com/docs/searching-and-filtering" target="_blank">Filtering responses</a> DevPortal article.

fieldsstring

Return only the specified fields in the response. For more information, see our <a href="https://developers.belvo.com/docs/searching-and-filtering" target="_blank">Filtering responses</a> DevPortal article.

Request body

linkstring uuid required

The link.id you want to retrieve information for.

attach_pdfboolean

When set to true, you will receive the PDF in binary format in the response.

save_databoolean

Indicates whether or not to persist the data in Belvo. By default, this is set to true and we return a 201 Created response.

When set to false, the data won't be persisted and we return a 200 OK response.

Example request

{
  "link": "c81a1dea-6dd6-4999-8b9f-541ee8197058",
  "attach_pdf": true,
  "save_data": true
}

Response

Ok (when save_data=false)

idstring uuid

Belvo's unique identifier for the current item.

linkstring uuid nullable

The link.id the data belongs to.

collected_atstring date-time

The ISO-8601 timestamp when the data point was collected.

created_atstring date-time

The ISO-8601 timestamp of when the data point was created in Belvo's database.

Example response

[
  {
    "id": "0d3ffb69-f83b-456e-ad8e-208d0998d71d",
    "link": "30cb4806-6e00-48a4-91c9-ca55968576c8",
    "collected_at": "2022-02-09T08:45:50.406032Z",
    "created_at": "2022-02-09T08:45:50.406032Z",
    "entity_details": {
      "incorporation_date": "24-09-2010",
      "start_date": "24-09-2010",
      "document_id_type": "RUT",
      "document_id_number": "197476427-K",
      "name": "Empresa de Prueba"
    },
    "addresses": [
      {
        "type": "PRIMARY",
        "date": "24-09-2010",
        "address": "Calle Falsa 123"
      }
    ],
    "emails": [
      {
        "type": "CONTACT",
        "email": "mi-email@empresa.cl"
      }
    ],
    "phone_numbers": [
      {
        "type": "LANDLINE"
      }
    ],
    "economic_activities": [
      {
        "type": "ASESORIA EN INGENIERIA",
        "activity": "ACTIVIDADES DE CONSULTORIA DE GESTION",
        "code": "702000",
        "tax_category": 1,
        "vat_affected": true,
        "start_date": "24-09-2010"
      }
    ],
    "legal_representative": [
      {
        "is_current": true,
        "name": "Juan Perez",
        "document_id_type": "RUT",
        "document_id_number": "12345678-9",
        "start_date": "24-09-2010"
      }
    ],
    "equity_holders": [
      {
        "is_current": true,
        "name": "Juan Perez",
        "document_id_type": "RUT",
        "document_id_number": "12345678-9",
        "start_date": "24-09-2010",
        "capital_contributed": 1000000,
        "capital_contribution_outstanding": 3750,
        "ownership_share": 25.25,
        "profit_share": 31.25
      }
    ],
    "company_partnership_stakes": [
      {
        "name": "Empresa de Prueba",
        "document_id_type": "RUT",
        "document_id_number": "12345678-9",
        "start_date": "24-09-2010",
        "capital_contributed": 1000000.02,
        "capital_contribution_outstanding": 3750.02,
        "ownership_share": 25.25,
        "profit_share": 31.25
      }
    ],
    "regimes": [
      {
        "type": "MICRO EMPRESA",
        "start_date": "2023-01-01"
      }
    ],
    "authorized_tax_documents": [
      {
        "type": "CONTABILIDAD EN HOJAS SUELTAS CON NRO.UN",
        "document_limit": 2000,
        "authorization_date": "2010-18-11"
      }
    ],
    "property_tax_liabilities": [
      {
        "property_id": "12345",
        "district": "NUNAO",
        "address": "123 Example Street",
        "type": "HABITACIONAL",
        "overdue_tax_payments": [
          {
            "year": 2023,
            "installment": 1,
            "due_date": "2023-04-30",
            "amount_due": 19.864
          }
        ],
        "scheduled_tax_payments": [
          {
            "year": 2023,
            "installment": 1,
            "due_date": "2023-04-30",
            "amount_due": 19.864
          }
        ]
      }
    ],
    "fiscal_office": {
      "name": "VIÑA DEL MAR",
      "address": "ARLEGUI 525, VIÑA DEL MAR"
    }
  }
]

v1

Retrieve tax statuses for a link

Query parameters

Request body

Example request

Response

Example response