> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.omni-ward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Domínios CNPJ

> SERVICE_DOMAINS_CNPJ · Consulta de sites e domínios associados ao CNPJ, incluindo atividade, SSL, provedor, tecnologias, redes sociais, pagamentos, WHOIS e vínculos com sócios encontrados.

> [!NOTE]
>
> Alias: `SERVICE_DOMAINS_CNPJ` · Preço: **R\$ 0,50** por consulta

Consulta de sites e domínios associados ao CNPJ, incluindo atividade, SSL, provedor, tecnologias, redes sociais, pagamentos, WHOIS e vínculos com sócios encontrados.

Execute pelo endpoint único [`POST /v1/services`](https://api-docs.omni-ward.com/api-reference/executar-servicos). Você pode combinar este serviço com outros na mesma chamada, enviando cada identificador uma vez.

## Campos do request

| Campo | Obrigatório | Descrição |
| - | - | - |
| `services` | sim | Inclua `"SERVICE_DOMAINS_CNPJ"` na lista. |
| `cnpj` | sim | CNPJ, com ou sem pontuação. |

## Campos em `result`

| Campo | Descrição | Tipo |
| - | - | - |
| `total_domains` | Quantidade de Domínios | number |
| `total_active_domains` | Quantidade de Domínios Ativos | number |
| `domains_list` | Domínios Encontrados | text |
| `total_sites` | Quantidade de Sites | number |
| `main_domain` | Domínio Principal | text |
| `ssl_domains` | Domínios com SSL | text |
| `domain_classes` | Classes dos Domínios | text |
| `visitor_ranges` | Faixas de Visitantes | text |
| `frameworks` | Frameworks | text |
| `technologies` | Tecnologias | text |
| `isp_names` | Provedores de Hospedagem | text |
| `social_networks` | Redes Sociais | text |
| `payment_methods` | Métodos de Pagamento | text |
| `payment_services` | Serviços de Pagamento | text |
| `registered_in_whois` | Registrado no WHOIS | text |
| `main_domain_status` | Status dos Domínios | text |
| `domains_from_partners` | Domínios de Sócios | text |
| `has_ssl` | Possui SSL | text |

Todo `result` traz também `outcome`, o resumo da consulta: `clear`, `alert`, `match`, `no_match` ou `not_found`.

```bash cURL theme={null}
curl --request POST 'https://api.omni-ward.com/v1/services' \
  --header 'Authorization: Bearer $OMNI_WARD_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: $(uuidgen)' \
  --data '{
  "services": [
    "SERVICE_DOMAINS_CNPJ"
  ],
  "cnpj": "00000000000000"
}'
```

```javascript Node.js theme={null}
const res = await fetch('https://api.omni-ward.com/v1/services', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.OMNI_WARD_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    "services": [
      "SERVICE_DOMAINS_CNPJ"
    ],
    "cnpj": "00000000000000"
  }),
});
const { results } = await res.json();
```

```python Python theme={null}
import os, uuid, requests

res = requests.post(
    "https://api.omni-ward.com/v1/services",
    headers={"Authorization": f"Bearer {os.environ['OMNI_WARD_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
    json={
      "services": [
        "SERVICE_DOMAINS_CNPJ"
      ],
      "cnpj": "00000000000000"
    },
    timeout=90,
)
results = res.json()["results"]
```

```php PHP theme={null}
$ch = curl_init("https://api.omni-ward.com/v1/services");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("OMNI_WARD_API_KEY"),
    "Content-Type: application/json",
    "Idempotency-Key: " . bin2hex(random_bytes(16)),
  ],
  CURLOPT_POSTFIELDS => '{"services":["SERVICE_DOMAINS_CNPJ"],"cnpj":"00000000000000"}',
]);
$results = json_decode(curl_exec($ch), true)["results"];
```

```java Java theme={null}
var body = """
    {
      "services": [
        "SERVICE_DOMAINS_CNPJ"
      ],
      "cnpj": "00000000000000"
    }
    """;
var request = HttpRequest.newBuilder(URI.create("https://api.omni-ward.com/v1/services"))
    .header("Authorization", "Bearer " + System.getenv("OMNI_WARD_API_KEY"))
    .header("Content-Type", "application/json")
    .header("Idempotency-Key", UUID.randomUUID().toString())
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
```

```json 200 theme={null}
{
  "results": [
    {
      "service": "SERVICE_DOMAINS_CNPJ",
      "status": {
        "code": 200,
        "message": "Success"
      },
      "result": {
        "total_domains": 0,
        "total_active_domains": 0,
        "domains_list": "texto",
        "total_sites": 0,
        "main_domain": "texto",
        "ssl_domains": "texto",
        "domain_classes": "texto",
        "visitor_ranges": "texto",
        "frameworks": "texto",
        "technologies": "texto",
        "isp_names": "texto",
        "social_networks": "texto",
        "payment_methods": "texto",
        "payment_services": "texto",
        "registered_in_whois": "texto",
        "main_domain_status": "texto",
        "domains_from_partners": "texto",
        "has_ssl": "texto",
        "outcome": "clear"
      },
      "simulated": false,
      "costMinor": 50
    }
  ],
  "totalCostMinor": 50
}
```

```json 422 theme={null}
{
  "error": {
    "code": "validation_failed",
    "message": "Alguns serviços não podem ser executados. Nada foi consultado nem cobrado.",
    "correlationId": "4f1c9a7e-2b1d-4c55-9a51-0d2f6f1c2a10",
    "details": {
      "results": [
        {
          "service": "SERVICE_DOMAINS_CNPJ",
          "status": {
            "code": 422,
            "message": "Validation failed"
          },
          "result": null,
          "errors": [
            {
              "field": "cnpj",
              "code": "required",
              "message": "Informe CNPJ: este serviço exige o campo."
            }
          ]
        }
      ]
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.