List Invoices

curl --request GET \
  --url https://api.fintoc.com/v1/invoices

import requests

url = "https://api.fintoc.com/v1/invoices"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.fintoc.com/v1/invoices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fintoc.com/v1/invoices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fintoc.com/v1/invoices"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.fintoc.com/v1/invoices")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fintoc.com/v1/invoices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

"[{\n    \"id\": \"inv_nMNejK7BT8oGbvO4\",\n    \"object\": \"invoice\",\n    \"number\": \"135\",\n    \"institution_id\": \"cl_fiscal_sii\",\n    \"issuer\": {\n        \"id\": \"117056856\",\n        \"name\": \"Hooli SpA\",\n        \"institution_tax_payer\": null\n    },\n    \"receiver\": null,\n    \"issue_type\": \"received\",\n    \"date\": \"2021-06-25T04:00:00.000Z\",\n    \"total_amount\": 12123,\n    \"net_amount\": 1231,\n    \"currency\": \"CLP\",\n    \"institution_invoice\": {\n        \"received_at\": \"2021-06-25T19:27:04.000Z\",\n        \"accepted_at\": null,\n        \"confirmation_status\": null,\n        \"exempt_amount\": 0,\n        \"document_type\": \"34\",\n        \"total_documents\": null,\n        \"vat_amount\": 123,\n        \"fixed_assets_net_amount\": null,\n        \"fixed_assets_vat_amount\": null,\n        \"non_refundable_vat_amount\": null,\n        \"non_refundable_vat_code\": null,\n        \"non_credit_tax_amount\": null,\n        \"total_vat_withheld\": 0,\n        \"partial_vat_withheld\": 0,\n        \"non_withheld_vat\": 0,\n        \"own_vat\": 0,\n        \"third_party_vat\": 0,\n        \"common_use_vat\": null,\n        \"out_of_time_vat\": 0,\n        \"reference_type_code\": \"\",\n        \"reference_number\": \"\",\n        \"construction_company_credit\": \"\",\n        \"free_zone_tax\": \"\",\n        \"container_deposit_guarantee\": \"\",\n        \"domestic_ticket_sales\": \"\",\n        \"international_ticket_sales\": \"\",\n        \"receipt_reference_number\": \"\",\n        \"settlement_issuer_id\": \"\",\n        \"vat_commisions\": 0,\n        \"net_commissions\": 0,\n        \"exempt_commissions\": 0,\n        \"invoice_status\": \"registered\",\n        \"other_taxes\": {\n            \"total_amount\": \"\",\n            \"other_taxes_detail\": [\n                {\n                    \"tax_code\": 14,\n                    \"tax_rate\": \"19\",\n                    \"tax_amount\": 400\n                }\n            ]\n        },\n        \"tobacco_taxes\": {\n            \"cigars\": 0,\n            \"cigarettes\": 0,\n            \"processed_tobacco\": 0\n        }\n    }\n}]"

"{}"

GET

invoices

List Invoices

curl --request GET \
  --url https://api.fintoc.com/v1/invoices

import requests

url = "https://api.fintoc.com/v1/invoices"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.fintoc.com/v1/invoices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fintoc.com/v1/invoices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fintoc.com/v1/invoices"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.fintoc.com/v1/invoices")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fintoc.com/v1/invoices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

"[{\n    \"id\": \"inv_nMNejK7BT8oGbvO4\",\n    \"object\": \"invoice\",\n    \"number\": \"135\",\n    \"institution_id\": \"cl_fiscal_sii\",\n    \"issuer\": {\n        \"id\": \"117056856\",\n        \"name\": \"Hooli SpA\",\n        \"institution_tax_payer\": null\n    },\n    \"receiver\": null,\n    \"issue_type\": \"received\",\n    \"date\": \"2021-06-25T04:00:00.000Z\",\n    \"total_amount\": 12123,\n    \"net_amount\": 1231,\n    \"currency\": \"CLP\",\n    \"institution_invoice\": {\n        \"received_at\": \"2021-06-25T19:27:04.000Z\",\n        \"accepted_at\": null,\n        \"confirmation_status\": null,\n        \"exempt_amount\": 0,\n        \"document_type\": \"34\",\n        \"total_documents\": null,\n        \"vat_amount\": 123,\n        \"fixed_assets_net_amount\": null,\n        \"fixed_assets_vat_amount\": null,\n        \"non_refundable_vat_amount\": null,\n        \"non_refundable_vat_code\": null,\n        \"non_credit_tax_amount\": null,\n        \"total_vat_withheld\": 0,\n        \"partial_vat_withheld\": 0,\n        \"non_withheld_vat\": 0,\n        \"own_vat\": 0,\n        \"third_party_vat\": 0,\n        \"common_use_vat\": null,\n        \"out_of_time_vat\": 0,\n        \"reference_type_code\": \"\",\n        \"reference_number\": \"\",\n        \"construction_company_credit\": \"\",\n        \"free_zone_tax\": \"\",\n        \"container_deposit_guarantee\": \"\",\n        \"domestic_ticket_sales\": \"\",\n        \"international_ticket_sales\": \"\",\n        \"receipt_reference_number\": \"\",\n        \"settlement_issuer_id\": \"\",\n        \"vat_commisions\": 0,\n        \"net_commissions\": 0,\n        \"exempt_commissions\": 0,\n        \"invoice_status\": \"registered\",\n        \"other_taxes\": {\n            \"total_amount\": \"\",\n            \"other_taxes_detail\": [\n                {\n                    \"tax_code\": 14,\n                    \"tax_rate\": \"19\",\n                    \"tax_amount\": 400\n                }\n            ]\n        },\n        \"tobacco_taxes\": {\n            \"cigars\": 0,\n            \"cigarettes\": 0,\n            \"processed_tobacco\": 0\n        }\n    }\n}]"

"{}"

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

Headers

Authorization

string

default:sk_test_9c8d8CeyBTx1VcJzuDgpm4H

Fintoc Secret Key

Query Parameters

link_token

string

default:link_6n12zLmai3lLE9Dq_token_gvEJi8FrBge4fb3cz7Wp856W

The access token of the Link that holds the Invoices to list, returned when creating said Link.

since

string<date>

default:2021-01-01

Date using <<glossary:ISO 8601>>. If present, return only Invoices with date equal or after since.

until

string<date>

default:2021-01-31

Date using <<glossary:ISO 8601>>. If present, return only Invoices with date before until (exclusive).

updated_since

string<date>

default:2021-01-01T00:00:00.000Z

Date using <<glossary:ISO 8601>>. If present, return only Invoices that have updated since updated_since (including it).

issue_type

enum<string>

default:issued

If present, return ony Invoices with the indicated issue type.

Available options:

issued,

received

invoice_status

enum<string>

default:registered

If present, return only Invoices with the indicated status.

Available options:

pending,

registered

Response

200

string

Example:

"inv_nMNejK7BT8oGbvO4"

object

string

Example:

"invoice"

number

string

Example:

"135"

institution_id

string

Example:

"cl_fiscal_sii"

issuer

object

Show child attributes

receiver

any

issue_type

string

Example:

"received"

date

string

Example:

"2021-06-25T04:00:00.000Z"

total_amount

integer

default:0

Example:

12123

net_amount

integer

default:0

Example:

1231

currency

string

Example:

"CLP"

institution_invoice

object

Show child attributes

Invoice object Tax Statement object

Fintoc API

Main Resources

Payment Initiation API

Transfers API

Movements API

Direct Debit and Subscriptions

Fiscal API

Billing API

List Invoices

Headers

Query Parameters

Response