TOO_MANY_RECORDS

Too many records: ‹value› (maximum: ‹value›)

Category: Customers


HTTP status	`400` Bad Request or `422` Unprocessable Content

HTTP status

This code can arrive with 400 Bad Request or 422 Unprocessable Content, depending on the operation. Branch on error.code, not on the status alone.

Example response

When this error occurs, the API returns a JSON response with the following shape:

{
  "type": "https://docs.beel.es/errors/TOO_MANY_RECORDS",
  "title": "TOO_MANY_RECORDS",
  "detail": "Too many records: ‹value› (maximum: ‹value›)",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "TOO_MANY_RECORDS",
    "message": "Too many records: ‹value› (maximum: ‹value›)",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

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

Message

Too many records: ‹value› (maximum: ‹value›)

Demasiados registros: ‹value› (máximo: ‹value›)

Massa registres: ‹value› (màxim: ‹value›)

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

ALTERNATIVE_ID_ACTUALLY_IN_CENSUS

The identifier '‹value›' is registered in the AEAT census, so it cannot be declared as not registered (07). Enter it as a NIF instead.

ALTERNATIVE_ID_AND_NIF_EXCLUSIVE

The customer cannot carry both a NIF and an alternative identifier. Use only one

ALTERNATIVE_ID_COUNTRY_REQUIRED

The country of the alternative identifier is missing (alternative_id.country_code). It is required except for the PASSPORT and NOT_REGISTERED types, which are taken as Spanish when it is omitted.

ALTERNATIVE_ID_INVALID

The alternative identifier is not valid

ALTERNATIVE_ID_REQUIRES_SPAIN

Type NOT_REGISTERED (07) is only valid for Spain; received country: '‹value›'