curl --request GET \
--url https://api.fintoc.com/v2/entities \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v2/entities"
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/v2/entities', 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/v2/entities",
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/v2/entities"
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/v2/entities")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/entities")
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": "ent_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
"object": "entity",
"capabilities": {
"account_holder": {
"status": "operational"
},
"settlement_recipient": {
"status": "operational"
}
},
"country_code": "mx",
"holder_id": "AAA010101AAA",
"holder_name": "Test Entity 1",
"is_root": true,
"mode": "test",
"status": "operational"
},
{
"id": "ent_2rNxBkOrlHoOYsZTyQYhA0o8Ek0",
"object": "entity",
"capabilities": {
"account_holder": {
"status": "draft"
},
"settlement_recipient": {
"status": "operational"
}
},
"country_code": "us",
"holder_id": "XEXX010101000",
"holder_name": "Test Entity 2",
"is_root": false,
"mode": "test",
"status": "operational"
}
]{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}Entities list
curl --request GET \
--url https://api.fintoc.com/v2/entities \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v2/entities"
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/v2/entities', 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/v2/entities",
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/v2/entities"
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/v2/entities")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/entities")
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": "ent_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
"object": "entity",
"capabilities": {
"account_holder": {
"status": "operational"
},
"settlement_recipient": {
"status": "operational"
}
},
"country_code": "mx",
"holder_id": "AAA010101AAA",
"holder_name": "Test Entity 1",
"is_root": true,
"mode": "test",
"status": "operational"
},
{
"id": "ent_2rNxBkOrlHoOYsZTyQYhA0o8Ek0",
"object": "entity",
"capabilities": {
"account_holder": {
"status": "draft"
},
"settlement_recipient": {
"status": "operational"
}
},
"country_code": "us",
"holder_id": "XEXX010101000",
"holder_name": "Test Entity 2",
"is_root": false,
"mode": "test",
"status": "operational"
}
]{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}Autorizaciones
Parámetros de consulta
Tax ID of the entity owner. Fintoc normalizes the value by removing dots, hyphens, leading zeros, and surrounding whitespace, then uppercases letters before matching.
"AAA010101AAA"
One or more statuses to match: draft, under_review, pending_signature, canceled, waiting_initialization, operational, rejected, or paused. Returns entities whose status matches any value you provide. If any capability is operational, the entity matches only operational, not the other capability statuses.
draft, under_review, pending_signature, canceled, waiting_initialization, operational, rejected, paused If true, returns only the root entity of your organization. If false, returns only the non-root entities.
true
Cursor that fetches the next page of entities. Use the ID of the last entity from the current page.
"ent_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"
Cursor that fetches the previous page of entities. Use the ID of the first entity from the current page.
"ent_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"
Maximum number of entities to return per page. Ranges from 1 to 300. Defaults to 30.
50
Respuesta
List of entities for the current mode.
Unique identifier of the entity.
"ent_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
Type of the object. Always entity.
Statuses for the entity's capabilities. A capability is a role the entity can take in Fintoc, such as holding accounts or receiving settlements. Each capability has its own onboarding, so the statuses can differ.
Show child attributes
Show child attributes
ISO 3166-1 alpha-2 country code of the entity, in lowercase, or null when not set. For example, cl or mx.
"mx"
Tax ID of the entity owner, without dots or hyphens: the Chilean tax ID (RUT) in Chile or the Mexican tax ID (RFC) in Mexico. For a foreign entity in Mexico, the value is the generic foreign RFC XEXX010101000.
"AAA010101AAA"
Legal name of the entity owner.
"Test Entity 1"
Whether this entity is your organization's root entity.
true
Whether the entity belongs to live or test data. One of live or test.
live, test "test"
Overall status of the entity. The value is the most advanced status across the entity's capabilities. Statuses rank from least to most advanced: canceled, rejected, waiting_initialization, draft, under_review, pending_signature, paused y operational. Use capabilities to check each capability on its own.
draft, under_review, pending_signature, canceled, waiting_initialization, operational, rejected, paused "operational"
¿Esta página le ayudó?