CNP API Documentation

Integrate CNP validation and generation through a free public JSON API without tokens and with fair per-IP limits.

The API is public and returns JSON only: no token or account is required. Per-IP limits apply for fair use.
↓ OpenAPI Spec (JSON) ↓ Download Postman Collection

How it works

1

Choose a tool

Use automatic individual/bulk validation or the CNP generator.

2

Send JSON

POST endpoints accept only Content-Type: application/json.

3

Receive JSON

Both successful results and all errors use predictable JSON responses.

Choose an endpoint

POST

CNP Validation

One endpoint for individual and bulk validation. The mode is detected automatically from the input.

/api/v1/cnp/validate
View documentation and live test →
POST

CNP Generator

Generate valid CNP values with only a limit or any combination of the available filters.

/api/v1/cnp/generate
View documentation and live test →

Common rules

  • Romanian is the default language; send "lang": "en" for English output.
  • An invalid CNP is a valid operation result: HTTP 200 with "valid": false.
  • Limits: 60 requests/minute for validation, 10 requests/minute for generation, and 120 requests/minute for resources.
  • An invalid request returns JSON with an HTTP 4xx status; exceeding a limit returns HTTP 429.
  • CSV is sent as text in the JSON input field; multipart uploads are not accepted.