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

# Buscar contato por CPF

> Busca um signatário na agenda pelo CPF. Retorna não-encontrado sem erro.

Busca rápida de um contato pelo CPF. Útil para verificar se um signatário já está na agenda ao preencher envelopes — se encontrado, preenche automaticamente nome, e-mail, telefone, etc.

**Autenticação**: `x-api-key` no header. Também aceita `Authorization: Bearer`.

## Parâmetros

<ParamField path="cpf" type="string" required>
  CPF do contato (com ou sem máscara: `123.456.789-01` ou `12345678901`).
</ParamField>

## Respostas

<ResponseField name="found" type="boolean">
  Se o contato foi encontrado (`true` ou `false`).
</ResponseField>

<ResponseField name="contact" type="object" nullable>
  Dados do contato, preenchido apenas se `found: true`. Mesma estrutura de [`GET .../signer-contacts`](/plataforma/assinatura-digital/api/get-signer-contacts).
</ResponseField>

## Erros

Veja [Autenticação e erros](/plataforma/assinatura-digital/api/erros-e-autenticacao).

* **400**: CPF inválido (formato).
* **401**: API key inválida.

**Nota**: não achar o contato **não é erro** — retorna 200 com `found: false`.

<ResponseExample>
  ```json theme={"theme":"catppuccin-latte"}
  HTTP/1.1 200 OK
  Content-Type: application/json

  {
    "found": true,
    "contact": {
      "uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "name": "João Silva",
      "cpf": "12345678901",
      "cpfFormatted": "123.456.789-01",
      "email": "joao@empresa.com",
      "phoneCountryCode": "55",
      "phoneNumber": "11987654321",
      "birthDate": "1990-05-15",
      "qualification": "Contratante"
    }
  }
  ```

  ```json theme={"theme":"catppuccin-latte"}
  HTTP/1.1 200 OK
  Content-Type: application/json

  {
    "found": false,
    "contact": null
  }
  ```
</ResponseExample>

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X GET "https://api.valid.com/signer/v1/signer-contacts/by-cpf/123.456.789-01" \
  -H "x-api-key: YOUR_API_KEY"
```

## Importante

* **Não-encontrado não é erro**: a busca retorna 200 em ambos os casos (encontrado e não encontrado). Cheque `found` para saber o resultado.
* **CPF com ou sem máscara**: aceita ambos.
* **Escopo por projeto**: busca apenas na agenda do seu projeto.

## Relacionado

* [`GET .../signer-contacts`](/plataforma/assinatura-digital/api/get-signer-contacts) — listar todos
* [`POST .../signer-contacts`](/plataforma/assinatura-digital/api/post-signer-contact) — cadastrar novo


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