# Listar subcontas
`GET /v1/accounts/subaccounts`
**Área:** Subcontas ValidaPay

**Scopes necessários:** `subaccounts/read`

Com esta rota você poderá listar todas as subcontas associadas à sua _master account_

### Query parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `dateFrom` | não |  |
| `dateTo` | não |  |
| `page` | não |  |
| `perPage` | não |  |

### Request body

```json
{
    "amount": 1.00, 
    "split": [
        {
            "type": "fixed",
            "amount": 0.10
        }
    ]
}
```

### Campos do body

**Obrigatórios:** `amount`, `type`

| Campo | Descrição |
|---|---|
| `amount` | Valor com precisão de duas casas decimais separado por ponto |
| `type` | Valor fixo ou porcentagem |

### Resposta 200 — 200

```json
{
    "masterAccountId": "SANDBOX_0438f4c8-0031-7051-16d4-5a23704756b6",
    "subAccounts": [
        {
            "documentNumber": "66677788830",
            "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": "33344455508",
            "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"
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/get-listar-subcontas
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json