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",
"holder_id": "AAA010101AAA",
"holder_name": "Test Entity 1",
"is_root": true,
"mode": "test",
"status": "operational",
"country_code": "mx",
"capabilities": {
"account_holder": {
"status": "operational"
},
"settlement_recipient": {
"status": "operational"
}
}
},
{
"id": "ent_2rNxBkOrlHoOYsZTyQYhA0o8Ek0",
"object": "entity",
"holder_id": "XEXX010101000",
"holder_name": "Test Entity 2",
"is_root": false,
"mode": "test",
"status": "operational",
"country_code": "us",
"capabilities": {
"account_holder": {
"status": "draft"
},
"settlement_recipient": {
"status": "operational"
}
}
}
]{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}List entities
Lists the entities of your organization for the mode (live or test) of the API key used. An entity is a legal holder of accounts and defines ownership and identity in Transfers. The list is paginated. Use the starting_after, ending_before, and limit query parameters to move through the list. The Link response header carries the URLs to navigate the paginated 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",
"holder_id": "AAA010101AAA",
"holder_name": "Test Entity 1",
"is_root": true,
"mode": "test",
"status": "operational",
"country_code": "mx",
"capabilities": {
"account_holder": {
"status": "operational"
},
"settlement_recipient": {
"status": "operational"
}
}
},
{
"id": "ent_2rNxBkOrlHoOYsZTyQYhA0o8Ek0",
"object": "entity",
"holder_id": "XEXX010101000",
"holder_name": "Test Entity 2",
"is_root": false,
"mode": "test",
"status": "operational",
"country_code": "us",
"capabilities": {
"account_holder": {
"status": "draft"
},
"settlement_recipient": {
"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"
Mexican tax ID (RFC) of the entity owner, without dots or hyphens. For a foreign entity, 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 operational when any capability is operational. Otherwise, the value matches the account_holder capability status. Use capabilities to check each capability on its own. One of draft, under_review, pending_signature, canceled, waiting_initialization, operational, rejected, or paused.
draft, under_review, pending_signature, canceled, waiting_initialization, operational, rejected, paused "operational"
¿Esta página le ayudó?