arrow_back All endpoints

HTTP Request

POST/api/v1/tools/http-request2 credits per callhttpapirequestwebhookdebug

Issues an arbitrary HTTP request - any method, your own headers and body - and returns the full response including headers a browser would hide. Requests to private and loopback address ranges are refused.

receipt_long
Why 2 credits?

One outbound request to a host we do not control, held open until it answers or times out. Priced above a DNS query because the response body must be read and buffered.

Any HTTP client works. Replace the key with one from your dashboard.

bash
curl -X POST https://toolkitbackend-j69m.onrender.com/api/v1/tools/http-request \
  -H "Authorization: Bearer tb_live_<your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://api.github.com/repos/dotnet/runtime",
  "method": "GET"
}'

Input

FieldTypeRequiredDefaultDescription
urlstringrequired- Absolute http or https URL to request.
methodstringoptionalGET HTTP method. Defaults to GET. One of: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
headersstringoptional- Request headers as a JSON object, or the same object encoded as a string. Example: {"Accept":"application/json"}.
bodystringoptional- Request body, sent as-is for methods that allow one.

Output

FieldTypeDescription
statusCodeintegerHTTP status code returned by the target.
headersobjectEvery response header, including ones browsers hide from scripts.
bodystringResponse body as text.
elapsedMsintegerRound-trip time in milliseconds.

Try it

Sends a real POST /api/v1/tools/http-request from your browser and charges 2 credits to your account.

Sign in to run this endpoint. New accounts start with free credits.