# Status de subconta
`GET /v1/proposals/:formId`
**Área:** Subcontas ValidaPay

**Scopes necessários:** `proposals/write`

@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:

``` json
{
  "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"
}

 ```

### Path parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `formId` | **sim** | Identificador único retornado no ato do envio da proposta |

### Resposta 200 — PF 200

```json
{
    "phoneNumber": "+5511912345678",
    "isPoliticallyExposedPerson": false,
    "documentNumber": "98765432100",
    "motherName": "Teste Mãe",
    "fullName": "Teste teste",
    "type": "PF",
    "birthDate": "31-12-2000",
    "email": "cliente@exemplo.com.br",
    "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"
    }
}
```

### Resposta 200 — PJ 200

```json
{
    "documentNumber": "99776655000113",
    "type": "PJ",
    "businessName": "FULANO SILVA PUBLICIDADE, PROMOCAO E PRODUCAO DE EVENTOS ESPORTIVOS LTDA",
    "tradingName": "NEY SILVA",
    "businessEmail": "titular@exemplo.com.br",
    "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": "55566677720",
            "motherName": "SELMA MARIA DA SILVA",
            "fullName": "FUNANO CRISTOVAO DA SILVA",
            "type": "PF",
            "birthDate": "30-11-1991",
            "email": "contato@exemplo.com.br"
        }
    ],
    "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
    }
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/get-status-de-subconta
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json