List movements

curl --request GET \
  --url https://api.fintoc.com/v1/accounts/{id}/movements \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.fintoc.com/v1/accounts/{id}/movements"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.fintoc.com/v1/accounts/{id}/movements', 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/accounts/{id}/movements",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$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/accounts/{id}/movements"

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

	req.Header.Add("Authorization", "<api-key>")

	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/accounts/{id}/movements")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fintoc.com/v1/accounts/{id}/movements")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

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

[
  {
    "id": "mov_BO381oEATXonG6bj",
    "object": "movement",
    "amount": -1717,
    "comment": "Pago arriendo",
    "currency": "CLP",
    "description": "Cargo Seguro Proteccion Bancaria",
    "document_number": null,
    "pending": false,
    "post_date": "2020-04-06T00:00:00.000Z",
    "recipient_account": null,
    "reference_id": "123740123",
    "sender_account": null,
    "status": "confirmed",
    "transaction_date": "2020-04-04T02:19:23.000Z",
    "transfer_id": "123740123",
    "type": "transfer"
  }
]

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_date",
    "param": "since",
    "message": "Invalid date: invalid-date. You need to provide a date in ISO 8601 format (YYYY-MM-DD)",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "Invalid API Key: invalid-*oken"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "payment_required",
    "message": "Your trial window expired or you have a pending payment. If you think that this is an error, send an email to soporte@fintoc.com. To catch up on payments, email billing@fintoc.com.",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

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

{
  "error": {
    "type": "invalid_request_error",
    "code": "missing_resource",
    "param": "id",
    "message": "No such account: acc_nMNejK7BT8oGbvO4",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

GET

accounts

{id}

movements

List movements

curl --request GET \
  --url https://api.fintoc.com/v1/accounts/{id}/movements \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.fintoc.com/v1/accounts/{id}/movements"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.fintoc.com/v1/accounts/{id}/movements', 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/accounts/{id}/movements",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$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/accounts/{id}/movements"

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

	req.Header.Add("Authorization", "<api-key>")

	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/accounts/{id}/movements")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fintoc.com/v1/accounts/{id}/movements")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

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

[
  {
    "id": "mov_BO381oEATXonG6bj",
    "object": "movement",
    "amount": -1717,
    "comment": "Pago arriendo",
    "currency": "CLP",
    "description": "Cargo Seguro Proteccion Bancaria",
    "document_number": null,
    "pending": false,
    "post_date": "2020-04-06T00:00:00.000Z",
    "recipient_account": null,
    "reference_id": "123740123",
    "sender_account": null,
    "status": "confirmed",
    "transaction_date": "2020-04-04T02:19:23.000Z",
    "transfer_id": "123740123",
    "type": "transfer"
  }
]

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_date",
    "param": "since",
    "message": "Invalid date: invalid-date. You need to provide a date in ISO 8601 format (YYYY-MM-DD)",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "Invalid API Key: invalid-*oken"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "payment_required",
    "message": "Your trial window expired or you have a pending payment. If you think that this is an error, send an email to soporte@fintoc.com. To catch up on payments, email billing@fintoc.com.",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

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

{
  "error": {
    "type": "invalid_request_error",
    "code": "missing_resource",
    "param": "id",
    "message": "No such account: acc_nMNejK7BT8oGbvO4",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

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

Using the per_page and page parametersIf you are missing movements in our API, try adjusting the per_page parameter to obtain more movements in your requests. Remember that the default value for this parameter is 30 and the maximum value is 300.Also, if you have more movements than the per_page value, try iterating through our pages using the page parameter. This way you can check all the pages of movements stored.

Authorizations

Authorization

string

header

required

Path Parameters

string

required

The id of the account that holds the movements to list.

Query Parameters

link_token

string

required

The link_token of the link that holds the account, obtained when you exchanged the link.

Example:

"link_Q0xVGPvijElLRMwE_token_FhsFVurz5q5FycHA5xxhTpzX"

since

string<date>

ISO 8601 date. If present, Fintoc returns only movements with post_date on or after since.

until

string<date>

ISO 8601 date. If present, Fintoc returns only movements with post_date on or before until.

updated_since

string<date>

ISO 8601 date. If present, Fintoc returns only movements created or updated after updated_since.

per_page

string

Number of movements per page. Defaults to 30. The maximum is 300.

page

integer<int32>

Page number to retrieve. Starts at 1.

confirmed_only

boolean

Whether to return only confirmed movements. Defaults to true. When false, the endpoint also returns movements with status processing, reversed, and manually_reversed.

Response

Paginated list of movements. The Link and X-Total-Count headers carry the pagination information.

string

required

Unique identifier of the movement.

Example:

"mov_BO381oEATXonG6bj"

object

any

required

Type of the object. Always movement.

amount

integer

required

Amount of the movement, in the smallest unit of the currency (CLP has no decimals, so the amount is in pesos). Negative for outflows.

Example:

-1717

comment

string | null

required

Comment the sender attached to the movement, as registered at the institution.

Example:

"Pago arriendo"

currency

string

required

Three-letter ISO 4217 currency code of the movement.

Pattern: ^[A-Z]{3}$

Example:

"CLP"

description

string

required

Description of the movement, as registered at the institution.

Example:

"Cargo Seguro Proteccion Bancaria"

document_number

string | null

required

Number of the document associated to the movement (for example, the check number). null if the movement has no associated document.

Example:

"4527230"

pending

boolean

required

Whether the movement is pending consolidation by the institution.

Example:

false

post_date

string<date-time>

required

ISO 8601 timestamp of when the institution consolidated the movement.

Example:

"2020-04-06T00:00:00.000Z"

recipient_account

null · object · null

required

Account that received the transfer. Only present for transfers; null for every other movement type.

Show child attributes

reference_id

string | null

required

Identifier of the movement at the institution: the transfer_id if present, otherwise the document_number.

Example:

"123740123"

sender_account

null · object · null

required

Account that sent the transfer. Only present for transfers; null for every other movement type.

Show child attributes

status

enum<string>

required

Status of the movement. processing means Fintoc is verifying whether the institution duplicated or reversed the movement.

Available options:

confirmed,

reversed,

processing,

manually_reversed

Example:

"confirmed"

transaction_date

string<date-time> | null

required

ISO 8601 timestamp of when the movement happened, with time precision. null when the institution only reports the post_date.

Example:

"2020-04-04T02:19:23.000Z"

transfer_id

string | null

required

Identifier of the transfer at the institution. null if the movement is not a transfer.

Example:

"123740123"

type

enum<string>

required

Type of the movement.

Available options:

check,

transfer,

other

Example:

"transfer"

Get a movement Account object

Fintoc API

Main Resources

Payments API

Transfers API

Movements API

Direct Debit (Legacy)

Fiscal API

List movements

Authorizations

Path Parameters

Query Parameters

Response