HTTP
HTTP Delay API
/delay/:secondsDelay an HTTP response by a chosen number of seconds.
No signup or API key required.
Parameters
secondsintegerrequired · path- Approximate delay in seconds, from 0 to 10. Network overhead adds to this delay.
formatenumoptional · query- Response format. Defaults to json.
jsontext
No request body. Unknown or repeated query parameters return HTTP 400.
Returns 200 OK
A JSON object with the following fields.
delayedinteger- The requested delay in seconds.
Plain text
With format=text: Only the delayed value, without the JSON wrapper.
Errors
Validation and service errors always return JSON, including when format=text.
errorstring- A machine-readable error code, such as invalid_parameter or rate_limited.
messagestring- A description of the problem.
400 Invalid parameters.
414 Query string exceeds 2048 characters.
429 Rate limit reached. Wait the seconds in Retry-After before retrying.
Usage notes
seconds: integer 0..10. Waits approximately that long. No busy loop or external request.
Test loading indicators, cancellation, or timeout handling. The wait is approximate, and network time adds to the chosen delay.
Responses are not cached. Browser requests are supported through open CORS.
120 requests per minute per IP, with up to 30 per 10 seconds, shared across APIs. Delay endpoints also allow only 20 requests per minute. Limits are approximate per Cloudflare location. Full usage limits ↗