# Consultar inscrição no DDA

**Área:** DDA

Retorna a inscrição da conta e o estado em que ela está. Use para saber se já dá para listar boletos.

`GET /v1/dda/subscription`

**Base URL Produção:** `https://api.validapay.com.br`  
**Base URL Sandbox:** `https://sandbox.validapay.com.br`

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

### Resposta 200: Sucesso

```json
{
    "accountNumber": "460851686",
    "documentNumber": "12345678901",
    "status": "ACTIVE",
    "celcoinSubscriptionId": "a1b2c3d4-0000-0000-0000-000000000000",
    "errorMessage": null,
    "createdAt": "2026-10-03T14:58:12.004Z",
    "updatedAt": "2026-10-03T14:58:12.004Z"
}
```


### Resposta 404: Sem inscrição

```json
{
    "error": {
        "message": "Conta não possui inscrição no DDA",
        "code": "DDA_SUBSCRIPTION_NOT_FOUND",
        "details": null,
        "timestamp": "2026-10-07T12:32:37.043Z"
    }
}
```


### Resposta 403: Indisponível em sandbox

```json
{
    "error": {
        "message": "Não disponível em ambiente de Sandbox",
        "code": "DDA_NOT_AVAILABLE_IN_SANDBOX",
        "details": null,
        "timestamp": "2026-10-07T12:32:37.043Z"
    }
}
```


---

Página: https://docs.validapay.com.br/referencia/get-consultar-inscricao-no-dda  
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json