Skip to main content
Every endpoint in GetRequest is a stable, public URL that sits in front of your traffic. Whether you’re mocking an API response during development or forwarding live requests to your production backend, the endpoint captures everything that passes through it — before it even decides where to send it.

​
What Is an Endpoint?

An endpoint is a uniquely addressable URL hosted under your project that accepts HTTP requests. You configure each endpoint with a method, a slug, and an action that determines what happens to incoming traffic. Because GetRequest owns the URL, you can change the behavior of that URL at any time without touching your clients, webhooks, or integrations. The full URL for any endpoint follows this pattern:
For example, if your project URI is ddfkU760XMs2z7te and your slug is payment-webhook, your endpoint lives at:
That URL never changes, even if you rename the endpoint, swap its action type, or update the upstream target.

​
Endpoint Types

GetRequest gives you two action types. You can switch between them at any time with no downtime.

​
JSON Endpoints

A JSON endpoint returns a static response body you define in the dashboard. It always responds with HTTP 200, making it ideal for mocking third-party APIs, standing up fake webhook targets, or unblocking frontend work before a backend is ready.

​
Forward Endpoints

A Forward endpoint acts as a transparent proxy. GetRequest receives the incoming request, forwards it to the upstream URL you configure, and returns the real response — status code, headers, and body — back to the caller. Use this type for production and staging traffic where you need the real backend behavior alongside GetRequest’s logging and reliability layer.

​
Creating an Endpoint

When you create an endpoint, you configure four fields:
​
string
required
A human-readable label for the endpoint, displayed in your dashboard. This does not affect the URL.
​
string
required
The URL path segment appended to your project URI. Once set, this forms the permanent endpoint URL. Use lowercase letters, numbers, and hyphens (e.g. payment-webhook).
​
string
required
The HTTP method this endpoint accepts. Choose from GET, POST, PUT, PATCH, or DELETE.
​
string
required
The behavior of the endpoint. Set to JSON to return a static response, or Forward to proxy requests to an upstream URL.

​
Switching Between Types

You can toggle any endpoint between JSON and Forward directly from the dashboard. The switch takes effect immediately — there is no redeployment, no DNS change, and no interruption to incoming traffic. This makes it straightforward to:
  • Promote a mock endpoint to a real forward when your backend is ready
  • Temporarily switch a forward endpoint to JSON to absorb traffic during an outage
  • Test downstream behavior against a controlled static response at any time
Both JSON and Forward endpoints log every request that arrives, regardless of the action type or response outcome. Switching types never creates a gap in your log history.

​
Endpoint URL Structure

The endpoint URL is constructed from two parts you control:
  • project_uri — A unique identifier assigned to your project (e.g. ddfkU760XMs2z7te). You can find it in your project settings.
  • slug — The path segment you define when creating the endpoint.
The base domain e.getrequest.io is fixed and shared across all GetRequest customers. Your project URI ensures all requests are routed to the correct project.
Point your webhook providers, API clients, or SDKs at the endpoint URL as early as possible. Because the URL is stable, you can capture real traffic immediately and change the action type later without updating your integration.