efrisapi.com

Error codes / 1526

EFRIS error 1526 — pageSize must be 99 or less

Paged queries reject a pageSize of 100 even though the field description permits it. Use 99 or fewer.

The documentation says the value cannot be greater than 100. The live service rejects 100. Use 99.

What it actually means

The bound is exclusive in practice where the specification reads it as inclusive. It applies across the paged interfaces — goods and services (T127), stock records, transfer records and the other list queries.

The fix

Cap page size at 99 wherever you page, and prefer a smaller page for large result sets: paging is cheap, and a rejected page costs a whole round trip.

# 100 is rejected; 99 is the effective maximum.
GET /api/external/efris/goods?pageNo=1&pageSize=99
X-API-Key: <your key>

# Page until a request returns no records:
#   pageNo=1&pageSize=99
#   pageNo=2&pageSize=99
#   ...
# Do not silently reduce a caller's requested page size - the pageCount
# URA returns is derived from the size actually used.

Why this happens

Do not silently truncate a caller's requested page size to fit. The page count returned by URA is derived from the size actually used, so quietly changing it corrupts the arithmetic a paginating caller depends on.

Related


EFRIS Gateway handles this case already — it is one of the rejections it was calibrated against. It is a complete multi-tenant EFRIS platform, sold as source. This page stays free either way.