Nominais permitidas à subconta

GET

/api/subaccounts/{{subaccount_id}}/nominal

Autenticação

Bearer Token = API Key do master white-label (flag whiteLabelEnabled + escopo subaccounts:read). Sem a flag → 404 (rota invisível).

Nominais permitidas à subconta

Lista as nominais visíveis para a subconta indicada, no mesmo formato do catálogo do usuário (slug, displayName, isPremium, usable, feePixIn, feeWithdrawal, isCurrent, isFallback). Quem consulta e opera é sempre o master, via /api/subaccounts/{id}/nominal.

Path

Param	Descrição
`{{subaccount_id}}`	Id da subconta.

Resposta

200 OK com { data: NominalItem[] }.

Erros

HTTP	Quando
401 / 403	API key ausente / escopo insuficiente.
404	Sem a flag `whiteLabelEnabled`, ou subconta inexistente/não pertencente ao master.

Exemplo cURL

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Header

Respostas

🟢200

application/json

Bodyapplication/json

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff '/api/subaccounts/{{subaccount_id}}/nominal' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso (200)

{
  "data": [
    {
      "slug": "padrao",
      "displayName": "Padrão",
      "isPremium": false,
      "usable": true,
      "feePixIn": 2.99,
      "feeWithdrawal": 1.99,
      "isCurrent": true,
      "isFallback": false
    },
    {
      "slug": "hub",
      "displayName": "Hub",
      "isPremium": true,
      "usable": true,
      "feePixIn": 2.49,
      "feeWithdrawal": 1.49,
      "isCurrent": false,
      "isFallback": false
    }
  ]
}