Subcontas ValidaPay

Listar Subcontas

Com esta rota você poderá listar todas as subcontas associadas à sua master account

GET/v1/accounts/subaccounts

Base URL Produção:https://api.validapay.com.br

Base URL Sandbox:https://sandbox.validapay.com.br

Authorizations

bearer

Authorization

string · header · required

Cabeçalho de autenticação Bearer no formato Bearer {{token}} onde {{token}} é o seu token OAuth2.

Escopos requeridos

subaccounts/read

Body

text/plain

Content-Type:text/plain

{
    "amount": 1.00, //required - Valor com precisão de duas casas decimais separado por ponto
    "split": [
        {
            "type": "fixed",//required - Valor fixo ou porcentagem
            "amount": 0.10
        }
    ]
}

Query Parameters

Name	Type	Value	Required
dateFrom	-	2026-02-01T00:00:00.000Z	Optional
dateTo	-	2026-02-23T23:59:59.999Z	Optional
page	-	1	Optional
perPage	-	15	Optional

← Anterior

Status de subconta

Listar cobranças

const url = 'https://sandbox.validapay.com.br/v1/accounts/subaccounts?dateFrom=2026-02-01T00:00:00.000Z&dateTo=2026-02-23T23:59:59.999Z&page=1&perPage=15?dateFrom=2026-02-01T00%3A00%3A00.000Z&dateTo=2026-02-23T23%3A59%3A59.999Z&page=1&perPage=15';

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer {{token}}'
  },
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response Examples

200200

{
    "masterAccountId": "SANDBOX_0438f4c8-0031-7051-16d4-5a23704756b6",
    "subAccounts": [
        {
            "documentNumber": "96707067001",
            "createdAt": "2026-02-23T22:29:52.537Z",
            "accountNumber": "4960589",
            "status": "CONFIRMED",
            "onboardingId": "b9790268-a770-4aec-8fe5-d891f17e8007",
            "name": "Friedrich Nietzsche",
            "dailyWithdrawalLimit": 3000,
            "balance": 0
        },
        {
            "documentNumber": "14282497700",
            "createdAt": "2026-02-17T20:38:45.664Z",
            "accountNumber": "4949228",
            "status": "CONFIRMED",
            "onboardingId": "30608b18-7258-437d-a6cb-63e5882e4fb7",
            "name": "Tales de Mileto",
            "dailyWithdrawalLimit": 3000,
            "balance": 170.9
        }
    ],
    "page": 1,
    "perPage": 15,
    "hasMore": false,
    "dateFrom": "2026-02-01T00:00:00.000Z",
    "dateTo": "2026-02-23T23:59:59.999Z"
}

← Anterior

Status de subconta

Listar cobranças