Help

Why Does My Bulk Domain or TLD Search API Request Fail?

If your bulk search for domains or TLDs is failing, the most common cause is that the request exceeds the maximum payload size allowed by the API.

The following endpoints enforce a strict limit on the number of items per request:

  • POST /v1/domains/bulk-search

  • POST /v1/tlds/bulk-lookup

Each of these endpoints accepts up to 50 items per request. If you submit 51 or more items, the API rejects the request and the entire operation fails.

To resolve this issue:

  • Ensure that each bulk request contains no more than 50 items.

  • If you need to process more than 50 items, split your input into multiple requests, so that each batch stays within the 50‑item limit.