NewProvince is only required for addresses in Spain
BeeL
Get startedMulti-NIFVeriFactuRulesStripeAPI referenceChangelog
ErrorsAll codes

NIF_REVOCADO

The NIF '‹value›' has been revoked by the AEAT and cannot operate


Category: General

HTTP status422 Unprocessable Content
RetryNo

When it happens

The NIF is registered in the AEAT census as revoked.

Retry

Do not retry. The outcome is final: sending the same request again gets the same answer.

Rules that cite this code

Example response

When this error occurs, the API answers 422 Unprocessable Content with a JSON body of this shape:

{
  "type": "https://docs.beel.es/errors/NIF_REVOCADO",
  "title": "NIF_REVOCADO",
  "detail": "The NIF '‹value›' has been revoked by the AEAT and cannot operate",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "NIF_REVOCADO",
    "message": "The NIF '‹value›' has been revoked by the AEAT and cannot operate",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

The type URI is stable and always resolves to this page.

Message

The NIF '‹value›' has been revoked by the AEAT and cannot operate
El NIF '‹value›' ha sido revocado por la AEAT y no puede operar
El NIF '‹value›' ha estat revocat per l'AEAT i no pot operar

Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.

Placeholders like ‹value› are filled in at runtime with the actual values of your request.

Other errors in this category

Keep exploring