Get an account
curl --request GET \
--url https://api.sandbox.tracefinance.com/v1/accounts/{accountId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sandbox.tracefinance.com/v1/accounts/{accountId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sandbox.tracefinance.com/v1/accounts/{accountId}', 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.sandbox.tracefinance.com/v1/accounts/{accountId}",
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: Bearer <token>"
],
]);
$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.sandbox.tracefinance.com/v1/accounts/{accountId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.sandbox.tracefinance.com/v1/accounts/{accountId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.tracefinance.com/v1/accounts/{accountId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
"customer": {
"id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890"
},
"owner": {
"type": "COMPANY",
"legalName": "Acme Ltda",
"taxId": {
"value": "11222333000181",
"type": "CNPJ"
},
"industry": "SOFTWARE_DEVELOPMENT",
"expectedMonthlyVolume": "FROM_0_TO_50000",
"address": {
"addressLine1": "Rua das Flores, 100",
"city": "São Paulo",
"country": "BR",
"postalCode": "01234-567",
"addressLine2": "Suite 456",
"state": "SP"
},
"ubos": [
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"name": "João Silva",
"taxId": {
"value": "11222333000181",
"type": "CNPJ"
},
"address": {
"addressLine1": "Rua das Flores, 100",
"city": "São Paulo",
"country": "BR",
"postalCode": "01234-567",
"addressLine2": "Suite 456",
"state": "SP"
},
"phone": "5511999999999",
"email": "joao.silva@example.com",
"isLegalRepresentative": false,
"currentState": {
"status": "PENDING",
"createdAt": "2026-01-15T10:30:00Z",
"reason": {
"code": "DOCUMENT_REJECTED",
"message": "Document is illegible",
"details": {}
}
},
"ownershipPercentage": 50
}
]
},
"assets": [
{
"currency": "BRL",
"allowsVirtualAccounts": false,
"status": "ONBOARDING"
}
],
"requirements": {
"currentlyDue": [
{
"type": "ACCOUNT_DOCUMENT",
"documentType": "ARTICLES_OF_ASSOCIATION",
"documentSubType": "FRONT_SIDE",
"requiredMetadata": [
"country"
],
"metadata": {},
"reason": {
"code": "DOCUMENT_REJECTED",
"message": "Document is illegible",
"details": {}
}
}
],
"pendingVerification": [
{
"type": "ACCOUNT_DOCUMENT",
"documentType": "ARTICLES_OF_ASSOCIATION",
"documentSubType": "FRONT_SIDE",
"requiredMetadata": [
"country"
],
"metadata": {},
"reason": {
"code": "DOCUMENT_REJECTED",
"message": "Document is illegible",
"details": {}
}
}
],
"errors": [
{
"type": "ACCOUNT_DOCUMENT",
"documentType": "ARTICLES_OF_ASSOCIATION",
"documentSubType": "FRONT_SIDE",
"requiredMetadata": [
"country"
],
"metadata": {},
"reason": {
"code": "DOCUMENT_REJECTED",
"message": "Document is illegible",
"details": {}
}
}
],
"satisfied": [
{
"type": "ACCOUNT_DOCUMENT",
"documentType": "ARTICLES_OF_ASSOCIATION",
"documentSubType": "FRONT_SIDE",
"requiredMetadata": [
"country"
],
"metadata": {},
"reason": {
"code": "DOCUMENT_REJECTED",
"message": "Document is illegible",
"details": {}
}
}
]
},
"tags": [
{
"key": "psp",
"value": "Amazon"
},
{
"key": null,
"value": "hidden"
},
{
"key": "compliance-tier",
"value": "high"
}
],
"currentState": {
"status": "ACTION_REQUIRED",
"createdAt": "2026-01-15T10:30:00Z",
"reason": {
"code": "DOCUMENT_REJECTED",
"message": "Document is illegible",
"details": {}
}
},
"states": [
{
"status": "ACTION_REQUIRED",
"createdAt": "2026-01-15T10:30:00Z",
"reason": {
"code": "DOCUMENT_REJECTED",
"message": "Document is illegible",
"details": {}
}
}
],
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z",
"sourceAccountId": null
}
Get an account
Retrieves the details of an account by its ID.
GET
/
v1
/
accounts
/
{accountId}
Get an account
curl --request GET \
--url https://api.sandbox.tracefinance.com/v1/accounts/{accountId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sandbox.tracefinance.com/v1/accounts/{accountId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sandbox.tracefinance.com/v1/accounts/{accountId}', 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.sandbox.tracefinance.com/v1/accounts/{accountId}",
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: Bearer <token>"
],
]);
$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.sandbox.tracefinance.com/v1/accounts/{accountId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.sandbox.tracefinance.com/v1/accounts/{accountId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.tracefinance.com/v1/accounts/{accountId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
"customer": {
"id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890"
},
"owner": {
"type": "COMPANY",
"legalName": "Acme Ltda",
"taxId": {
"value": "11222333000181",
"type": "CNPJ"
},
"industry": "SOFTWARE_DEVELOPMENT",
"expectedMonthlyVolume": "FROM_0_TO_50000",
"address": {
"addressLine1": "Rua das Flores, 100",
"city": "São Paulo",
"country": "BR",
"postalCode": "01234-567",
"addressLine2": "Suite 456",
"state": "SP"
},
"ubos": [
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"name": "João Silva",
"taxId": {
"value": "11222333000181",
"type": "CNPJ"
},
"address": {
"addressLine1": "Rua das Flores, 100",
"city": "São Paulo",
"country": "BR",
"postalCode": "01234-567",
"addressLine2": "Suite 456",
"state": "SP"
},
"phone": "5511999999999",
"email": "joao.silva@example.com",
"isLegalRepresentative": false,
"currentState": {
"status": "PENDING",
"createdAt": "2026-01-15T10:30:00Z",
"reason": {
"code": "DOCUMENT_REJECTED",
"message": "Document is illegible",
"details": {}
}
},
"ownershipPercentage": 50
}
]
},
"assets": [
{
"currency": "BRL",
"allowsVirtualAccounts": false,
"status": "ONBOARDING"
}
],
"requirements": {
"currentlyDue": [
{
"type": "ACCOUNT_DOCUMENT",
"documentType": "ARTICLES_OF_ASSOCIATION",
"documentSubType": "FRONT_SIDE",
"requiredMetadata": [
"country"
],
"metadata": {},
"reason": {
"code": "DOCUMENT_REJECTED",
"message": "Document is illegible",
"details": {}
}
}
],
"pendingVerification": [
{
"type": "ACCOUNT_DOCUMENT",
"documentType": "ARTICLES_OF_ASSOCIATION",
"documentSubType": "FRONT_SIDE",
"requiredMetadata": [
"country"
],
"metadata": {},
"reason": {
"code": "DOCUMENT_REJECTED",
"message": "Document is illegible",
"details": {}
}
}
],
"errors": [
{
"type": "ACCOUNT_DOCUMENT",
"documentType": "ARTICLES_OF_ASSOCIATION",
"documentSubType": "FRONT_SIDE",
"requiredMetadata": [
"country"
],
"metadata": {},
"reason": {
"code": "DOCUMENT_REJECTED",
"message": "Document is illegible",
"details": {}
}
}
],
"satisfied": [
{
"type": "ACCOUNT_DOCUMENT",
"documentType": "ARTICLES_OF_ASSOCIATION",
"documentSubType": "FRONT_SIDE",
"requiredMetadata": [
"country"
],
"metadata": {},
"reason": {
"code": "DOCUMENT_REJECTED",
"message": "Document is illegible",
"details": {}
}
}
]
},
"tags": [
{
"key": "psp",
"value": "Amazon"
},
{
"key": null,
"value": "hidden"
},
{
"key": "compliance-tier",
"value": "high"
}
],
"currentState": {
"status": "ACTION_REQUIRED",
"createdAt": "2026-01-15T10:30:00Z",
"reason": {
"code": "DOCUMENT_REJECTED",
"message": "Document is illegible",
"details": {}
}
},
"states": [
{
"status": "ACTION_REQUIRED",
"createdAt": "2026-01-15T10:30:00Z",
"reason": {
"code": "DOCUMENT_REJECTED",
"message": "Document is illegible",
"details": {}
}
}
],
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z",
"sourceAccountId": null
}
Authorizations
JWT bearer token. Include as Authorization: Bearer <token>. See the Authentication guide for how to obtain one.
Headers
API version. Omit to use the default version.
Example:
"1"
Path Parameters
UUID of the account.
Response
Account details.
Example:
"a1b2c3d4-5e6f-7890-abcd-ef1234567890"
Show child attributes
Show child attributes
The legal entity that owns the account. Discriminated by type.
- Company
- Individual
Show child attributes
Show child attributes
Assets enabled on the account, with the onboarding status of the underlying provider account.
Show child attributes
Show child attributes
Requirement buckets grouped by lifecycle stage.
Show child attributes
Show child attributes
System-managed labels attached to the account. Some tags propagate to operations executed against this account.
Show child attributes
Show child attributes
Example:
[ { "key": "psp", "value": "Amazon" }, { "key": null, "value": "hidden" }, { "key": "compliance-tier", "value": "high" } ]
A point-in-time state of the account.
Show child attributes
Show child attributes
Full state history of the account.
Show child attributes
Show child attributes
Example:
"2026-01-15T10:30:00Z"
Example:
"2026-01-15T10:30:00Z"
Parent account ID. Null for named accounts.
Example:
null
Was this page helpful?
⌘I