FakeURL
DocumentationExamplesFAQ

Quick Start Tutorial

Get started with FakeURL in just 5 minutes

1
Basic Usage

The simplest way to use FakeURL is to request a status code:

GET https://fakeurl.dev/200

This returns a 200 OK response with an empty JSON object {}

Try it yourself:

curl https://fakeurl.dev/200
2
Add Delay

Simulate slow networks by adding a delay parameter (in milliseconds):

GET https://fakeurl.dev/200?delay=2000

This waits 2 seconds before responding. Perfect for testing loading states!

Use case:

Test your loading spinners, skeleton screens, or timeout handling

3
Return Custom JSON

Return your own JSON data using the json parameter:

GET https://fakeurl.dev/200?json={"userId":1,"name":"John","email":"john@example.com"}

The response will contain exactly the JSON you specified

💡 Tip:

Use the web UI at fakeurl.dev to generate URLs automatically without worrying about encoding!

4
Custom Headers

Add custom HTTP headers to the response:

GET https://fakeurl.dev/200?headers=X-Rate-Limit:100,X-Rate-Remaining:95

Headers are comma-separated key:value pairs

Common use cases:

  • • Test rate limiting headers
  • • Mock authentication tokens
  • • Simulate CORS headers
5
Combine Everything

Combine status code, delay, JSON, and headers in one URL:

GET https://fakeurl.dev/201?delay=1000&json={"created":true,"id":42}&headers=X-Request-ID:abc123

This simulates creating a resource: 201 status, 1s delay, success JSON, and tracking header

6
Different HTTP Methods

FakeURL works with all HTTP methods:

POST https://fakeurl.dev/201PUT https://fakeurl.dev/200DELETE https://fakeurl.dev/204

All methods use the same URL configuration - just change the HTTP method in your request

🎉 You're Ready!

Now you know how to use FakeURL for API mocking. Here's what to explore next:

📚 Examples

See practical use cases and scenarios

📖 Documentation

Complete API reference

❓ FAQ

Common questions answered

Product

  • Documentation
  • Examples
  • FAQ
  • Tutorial

Resources

  • HTTP Status Codes
  • GitHub
  • Changelog

Company

  • About
  • Blog
  • Twitter

Legal

  • Privacy Policy
  • Terms of Service

© 2025 FakeURL. All rights reserved.

Built with Next.js and shadcn/ui