Subcontas ValidaPay

Status de subconta

GET/v1/proposals/:formId

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

proposals/write

Path Parameters

Name	Type	Required	Description
formId	string	Required	Identificador único retornado no ato do envio da proposta

@botton
Quando a conta for aprovada, será enviado um evento na URL de webhook cadastrada nas rotas de criação de conta PF e PJ. O evento segue o seguinte layout:

{
  "event": "account_approved",
  "status": "CONFIRMED",
  "account": {
    "account": "123456",
    "branch": "0001",
    "documentNumber": "123456789",
    "ispb": "13935893",
    "name": "Werner Heisenberg"
  },
  "onboardingId": "fc0e6dab-8210-4f2d-8fce-2e94990b63ef",
  "documentNumber": "1234567889",
  "formId": "7b83fcb4-fe9c-4ad3-8d3a-621fe9c9ffc1",
  "createdAt": "2025-06-02T17:46:10.1120909"
}

← Anterior

Criar subconta PJ

Listar Subcontas

const url = 'https://sandbox.validapay.com.br/v1/proposals/:formId';

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

200PF 200

{
    "phoneNumber": "+5511912345678",
    "isPoliticallyExposedPerson": false,
    "documentNumber": "82117120083",
    "motherName": "Teste Mãe",
    "fullName": "Teste teste",
    "type": "PF",
    "birthDate": "31-12-2000",
    "email": "everton.silva@validapix.tech",
    "socialName": "",
    "address": {
        "number": "12",
        "addressComplement": "",
        "city": "Barueri",
        "street": "Alameda Xingu",
        "postalCode": "",
        "neighborhood": "Alphaville Industrial",
        "state": "SP"
    },
    "metaData": {
        "formId": "a6358673-dd00-4c6d-9592-df393513a78a",
        "createdAt": "2025-11-21T21:52:49.155Z",
        "updatedAt": "2025-11-21T21:53:43.213Z"
    },
    "proposalStatus": {
        "form": "UNFINISHED",
        "proposal": "PENDING",
        "documents": "PENDING",
        "urlDocumentscopy": "https://validapay.cadastro.io/0336bdddcd087923e2d0249b4cdd268d"
    }
}

200PJ 200

{
    "documentNumber": "11116404000161",
    "type": "PJ",
    "businessName": "FULANO SILVA PUBLICIDADE, PROMOCAO E PRODUCAO DE EVENTOS ESPORTIVOS LTDA",
    "tradingName": "NEY SILVA",
    "businessEmail": "sdgasgasf@gmail.com",
    "contactNumber": "+558145630249",
    "businessAddress": {
        "number": "10",
        "addressComplement": "CXPST 2",
        "city": "CHA GRANDE",
        "street": "ANTONIO",
        "postalCode": "55636000",
        "neighborhood": "CAMELA",
        "state": "PE"
    },
    "financialCompanyDetails": {
        "declaredCompanyRevenue": "DCRB02"
    },
    "owner": [
        {
            "ownerType": "SOCIO",
            "address": {
                "number": "10",
                "city": "CHA GRANDE",
                "street": "Av. Sao Jose",
                "postalCode": "55636000",
                "neighborhood": "Chã Grande",
                "state": "PE",
                "complement": ""
            },
            "financialOwnerDetails": {
                "ownerDeclaredIncome": "ODIB04"
            },
            "phoneNumber": "+558112345689",
            "isPoliticallyExposedPerson": false,
            "documentNumber": "68574699039",
            "motherName": "SELMA MARIA DA SILVA",
            "fullName": "FUNANO CRISTOVAO DA SILVA",
            "type": "PF",
            "birthDate": "30-11-1991",
            "email": "asfrgasfghafhafs@gmail.com"
        }
    ],
    "proposalId": "d0c39afa-d034-4330-8d57-527eacca88c6",
    "metaData": {
        "formId": "31aa2217-a149-40ba-847f-c23500a635c7",
        "createdAt": "2026-02-24T02:18:55.257Z",
        "updatedAt": "2026-02-24T02:29:04.911Z",
        "origin": "API"
    },
    "proposalStatus": {
        "form": "FINISHED",
        "sendStatus": "SENT",
        "proposal": "PENDING",
        "documents": "PENDING",
        "urlDocumentscopy": null
    }
}

← Anterior

Criar subconta PJ

Listar Subcontas