# Consulta PIS - Ministério do Trabalho

> Consulta a inscrição (PIS/NIT/NIS) de uma pessoa física no CNIS a partir do CPF. Retorna dados cadastrais como PIS, nome, data de nascimento e nome da mãe para validação e compliance.

- **Consulta:** `pis-trabalho`
- **Categoria:** Trabalhista
- **Preço:** R$ 0,43 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/pis-trabalho`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/trabalhista/pis-trabalho

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Este endpoint permite consultar o número de inscrição social (PIS, NIT ou NIS) de uma pessoa física registrada no Cadastro Nacional de Informações Sociais (CNIS), mantido pelo Ministério do Trabalho. É essencial para validação de identidades, verificação de dados cadastrais e conformidade com regulamentações de compliance e ESG.
>
> A consulta retorna informações básicas do indivíduo associadas ao seu número de inscrição no programa de integração social, facilitando processos de onboarding, análise de risco e decisões operacionais que exijam confirmação de identidade ou histórico laboral.

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/pis-trabalho?cpf=SEU_CPF"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/pis-trabalho",
    params={"cpf": "SEU_CPF"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/pis-trabalho");

url.search = new URLSearchParams({
  "cpf": "SEU_CPF"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cpf` | CPF | sim | CPF (somente números, 11 dígitos) | formato: 000.000.000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A resposta contém os dados associados à pessoa física consultada:
>
> | Campo | Tipo | Descrição |
> |-------|------|-----------|
> | cpf | string | CPF da pessoa consultada |
> | pis | string | Número de inscrição no Programa de Integração Social |
> | nome | string | Nome completo conforme registrado na base |
> | nomeMae | string | Nome da mãe da pessoa física |
> | dataNascimento | string | Data de nascimento no formato dd/MM/yyyy |

### Exemplo de resposta

```json
{
  "cpf": "string",
  "pis": "string",
  "nome": "string",
  "nomeMae": "string",
  "dataNascimento": "string"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "cpf": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF da pessoa física."
    },
    "pis": {
      "type": [
        "string",
        "null"
      ],
      "description": "Número de inscrição no Programa de Integração Social."
    },
    "nome": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome completo da pessoa física."
    },
    "consta": {
      "type": [
        "boolean",
        "null"
      ],
      "format": "bool",
      "description": "Indica se consta algum registro para o documento consultado."
    },
    "nomeMae": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome da mãe da pessoa física."
    },
    "mensagem": {
      "type": [
        "string",
        "null"
      ],
      "description": "Mensagem do resultado da consulta."
    },
    "parametros": {
      "type": [
        "object",
        "null"
      ],
      "description": "Parâmetros informados na consulta."
    },
    "dataNascimento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de nascimento da pessoa física."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. |
| `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. |
| `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. |
| `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - Esta consulta não gera comprovantes ou documentos de respaldo. Para fins de auditoria ou documentação formal, consulte canais oficiais do Ministério do Trabalho.
>
> - O gateway realiza validação básica do CPF antes de encaminhar a requisição. Verifique se o formato está correto ou deixe que a validação automática seja realizada.
>
> - A consulta pode não retornar resultado se a pessoa não possui inscrição ativa no CNIS, se os dados fornecidos não correspondem aos registros oficiais ou se houver restrições de acesso.
>
> - O serviço está sujeito a manutenções periódicas. Em caso de indisponibilidade, aguarde alguns minutos antes de tentar novamente.
>
> - Tempo de resposta pode variar conforme carga do serviço. Não há limite de timeout especificado, mas espere entre 2 e 30 segundos dependendo das condições de rede e infraestrutura.
>
> - Erros na requisição (parâmetros inválidos, autenticação falha, falta de saldo de consultas) são retornados pelo gateway com códigos HTTP apropriados. Consulte a documentação de códigos de status da API para mais detalhes.

---

Página em HTML: https://fontedata.com/docs/trabalhista/pis-trabalho
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp