---
title: "Look up a CPF"
method: GET
path: "/cpf/{cpf}"
tags: ["CPF"]
---

# Look up a CPF

`GET /cpf/{cpf}`

Returns identity data associated with the given CPF number.

- **Not found (404) does not consume a credit.** Only successful 200 responses are billed.
- The `gender` field is inferred from the full name.
- The `cpf` field in the response is always returned formatted as XXX.XXX.XXX-XX.

## Path parameters

- `cpf` string, required

## Response `200`

CPF found — identity data returned

- CPFResponse — Successful CPF lookup response
  - `success` boolean, required — Always true for 200 responses
  - `data` CPFData, required — Identity data associated with the CPF
    - `cpf` string, required — Formatted CPF (XXX.XXX.XXX-XX)
    - `name` string, required — Full name in title case
    - `nameUpper` string, required — Full name in uppercase
    - `gender` 'M' | 'F', required — Gender inferred from the full name (M = male, F = female)
    - `birthDate` string, required — Date of birth in DD/MM/YYYY format
    - `day` integer, required — Day of birth
    - `month` integer, required — Month of birth
    - `year` integer, required — Year of birth

## Other responses

- `400` — Invalid CPF format
- `401` — Missing or invalid API Key
- `403` — Suspended API key or insufficient credits
- `404` — CPF not found — does not consume a credit
- `422` — CPF check digits are invalid
- `429` — Rate limit exceeded
- `500` — Internal server error
- `503` — API temporarily unavailable

## Changes

- **2026-08-30** `b3a713b2361a` — 3 breaking, 14 info
  - the `error` response's property type/format changed from `object`/`` to `string`/`` for status `401`
  - removed the required property `error/code` from the response with the `401` status
  - removed the required property `error/message` from the response with the `401` status
  - removed the `INVALID_API_KEY` enum value from the `error/code` response property for the response status `400`
  - …13 more

[Change history](https://skmtc.dev/cpfhub/apis/cpfhub-io-api/changes/cpf/:cpf/get.md)

---

[API](https://skmtc.dev/cpfhub/apis/cpfhub-io-api.md) · [All operations](https://skmtc.dev/cpfhub/apis/cpfhub-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cpfhub/cpfhub-io-api/revisions/b3a713b2361a/schema)