curl --request GET \
--url https://api-global.fastpaybrasil.com/v1/submerchants/{merchantId}/legal-representatives \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api-global.fastpaybrasil.com/v1/submerchants/{merchantId}/legal-representatives"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api-global.fastpaybrasil.com/v1/submerchants/{merchantId}/legal-representatives', 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-global.fastpaybrasil.com/v1/submerchants/{merchantId}/legal-representatives",
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: Basic <encoded-value>"
],
]);
$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-global.fastpaybrasil.com/v1/submerchants/{merchantId}/legal-representatives"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
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-global.fastpaybrasil.com/v1/submerchants/{merchantId}/legal-representatives")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-global.fastpaybrasil.com/v1/submerchants/{merchantId}/legal-representatives")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "2vorkEaaaBbbCccDddEeeFffGgg",
"fullName": "Ana Principal",
"idNumber": "12345678900",
"email": "[email protected]",
"isPrimary": true,
"documents": {
"idFront": {
"id": "2vorkEdddEeeFffGggHhhIiiJjj",
"url": "https://storage.fastpaybrasil.com/documents/abc123?signature=...",
"status": "pending",
"rejectionReason": null,
"createdAt": "2026-08-05T14:30:00.000Z"
},
"idBack": {
"id": "2vorkEdddEeeFffGggHhhIiiJjj",
"url": "https://storage.fastpaybrasil.com/documents/abc123?signature=...",
"status": "pending",
"rejectionReason": null,
"createdAt": "2026-08-05T14:30:00.000Z"
},
"selfie": {
"id": "2vorkEdddEeeFffGggHhhIiiJjj",
"url": "https://storage.fastpaybrasil.com/documents/abc123?signature=...",
"status": "pending",
"rejectionReason": null,
"createdAt": "2026-08-05T14:30:00.000Z"
}
}
}
]
}{
"statusCode": 401,
"message": "Unauthorized"
}{
"statusCode": 404,
"message": "Subconta não encontrada"
}List submerchant legal representatives
Lista os representantes/sócios da subconta — o principal primeiro
(isPrimary: true) e depois os sócios adicionais.
Com include=documents, inclui os documentos de pessoa de cada sócio
(idFront, idBack, selfie). Chave ausente em documents = documento
não enviado. As url são assinadas e expiram em 1 hora — não as
armazene; consulte novamente quando precisar.
Retorna 404 quando a subconta não pertence ao master autenticado.
curl --request GET \
--url https://api-global.fastpaybrasil.com/v1/submerchants/{merchantId}/legal-representatives \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api-global.fastpaybrasil.com/v1/submerchants/{merchantId}/legal-representatives"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api-global.fastpaybrasil.com/v1/submerchants/{merchantId}/legal-representatives', 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-global.fastpaybrasil.com/v1/submerchants/{merchantId}/legal-representatives",
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: Basic <encoded-value>"
],
]);
$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-global.fastpaybrasil.com/v1/submerchants/{merchantId}/legal-representatives"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
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-global.fastpaybrasil.com/v1/submerchants/{merchantId}/legal-representatives")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-global.fastpaybrasil.com/v1/submerchants/{merchantId}/legal-representatives")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "2vorkEaaaBbbCccDddEeeFffGgg",
"fullName": "Ana Principal",
"idNumber": "12345678900",
"email": "[email protected]",
"isPrimary": true,
"documents": {
"idFront": {
"id": "2vorkEdddEeeFffGggHhhIiiJjj",
"url": "https://storage.fastpaybrasil.com/documents/abc123?signature=...",
"status": "pending",
"rejectionReason": null,
"createdAt": "2026-08-05T14:30:00.000Z"
},
"idBack": {
"id": "2vorkEdddEeeFffGggHhhIiiJjj",
"url": "https://storage.fastpaybrasil.com/documents/abc123?signature=...",
"status": "pending",
"rejectionReason": null,
"createdAt": "2026-08-05T14:30:00.000Z"
},
"selfie": {
"id": "2vorkEdddEeeFffGggHhhIiiJjj",
"url": "https://storage.fastpaybrasil.com/documents/abc123?signature=...",
"status": "pending",
"rejectionReason": null,
"createdAt": "2026-08-05T14:30:00.000Z"
}
}
}
]
}{
"statusCode": 401,
"message": "Unauthorized"
}{
"statusCode": 404,
"message": "Subconta não encontrada"
}Authorizations
HTTP Basic authentication. Use your secret key as the username and an empty string as password. The API key should be base64 encoded in the format 'username:' when sending the Authorization header.
Path Parameters
Id da subconta.
"2vorkDcXyvzifL63YX09S9VqcnI"
Query Parameters
Use documents para incluir os documentos de cada sócio.
documents "documents"
Response
Lista de representantes
Show child attributes
Show child attributes