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

FIELD_TOO_LONG

The field '‹value›' cannot exceed ‹value› characters.


Category: General

HTTP status422 Unprocessable Content
RetryAfter fixing the cause

When it happens

A text field is longer than it may be. The message names the field and its maximum length.

How to fix it

Shorten the field to the maximum the message gives and send the request again.

Retry

Not as is: the same request fails the same way. Fix the cause described above, then send the request again, under a new Idempotency-Key if the body changed.

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/FIELD_TOO_LONG",
  "title": "FIELD_TOO_LONG",
  "detail": "The field '‹value›' cannot exceed ‹value› characters.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "FIELD_TOO_LONG",
    "message": "The field '‹value›' cannot exceed ‹value› characters.",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

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

Message

The field '‹value›' cannot exceed ‹value› characters.
El campo '‹value›' no puede superar ‹value› caracteres.
El camp '‹value›' no pot superar ‹value› caràcters.

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