For developers
API request builder
Pick one of our documented operations and get a ready curl, Python or Node snippet, with the real base URL and an Idempotency-Key where the operation spends money.
Free, no accountIn your browser
One of the operations our API documents. Its parameters are filled with their own documented examples.
Which snippet to generate for the operation above.
Result
curl command ready
A ready curl request for POST /v1/numbers/orders, with https://resellerhq.com/api as the base URL and every parameter filled from its own documented example.
- Warning
Idempotency-Key is required on this operation
createNumberOrder spends money, so a request retried after a dropped connection needs the same Idempotency-Key and body to replay the stored response safely rather than buying a second time - the snippet below already carries a placeholder value.
Generate your own key per real request with crypto.randomUUID() (or an equivalent UUID v4) rather than reusing the placeholder below - the idempotency-key-generator tool shows the exact retry rules that key then follows.
curl request
Replace the placeholder environment variable with your own key - this never holds or sends a real one.
- This does not run the request - it only builds the snippet from the operation's own documented parameters, and cannot confirm a real call with a real key behaves the same way.
- A parameter with no documented example is filled with its own name as a placeholder, not a guessed real value.
What this is
This API request builder turns one of our documented operations into a snippet you can run as-is - the real base URL, the exact path and query parameters our OpenAPI document gives as examples, and an Idempotency-Key header on any operation that spends money.
Every operation here comes straight from the same committed OpenAPI document our own API docs are built from, never a hand-kept copy that can drift: the method, the path, every parameter and its documented example value, and whether that operation spends money. Picking an operation and a language only ever rearranges those facts into one of three shapes - it invents nothing about what the operation itself accepts.
An operation that can charge the wallet - ordering or renewing a number, registering or renewing a domain, buying or resizing a licence - gets an Idempotency-Key header in its snippet automatically, with a placeholder value standing in for the one your own client should generate per real request.
How to read the result
The snippet is ready to run once the placeholder environment variable is swapped for a real key: nothing here holds, generates or sends one. A path parameter such as a customer id is filled with its own documented example value rather than left as a literal brace, so the URL in the snippet is one that would actually resolve.
Switching the language keeps the same operation and the same example values, only the syntax around them changes - curl's own flags, Python's requests library, or Node's built-in fetch - so comparing the three side by side is a matter of changing one field, not rebuilding the request from scratch.
"Verifying one of our webhooks" uses a snippet built this way as its one documented-operation example, then covers what a request snippet alone does not: recomputing a webhook signature by hand, generating test secrets and keys, and reading every error code the resulting request might answer with.
Common mistakes
What goes wrong most often, and how to tell.
- Pasting the snippet with the placeholder environment variable still unsetThe snippet reads a key from an environment variable named in the snippet itself, never a literal value - run it with that variable actually set to your own key, or every request answers 401 before anything else about it is tested.
- Reusing the Idempotency-Key placeholder value across more than one real requestThe value shown for a money-spending operation is a fixed example for reading the shape of the header, not a key your own client should actually send more than once - generate a fresh one per real request, as the idempotency-key-generator tool explains.
Questions
What people ask about this tool.
- No. Nothing here makes a network call of its own - it only builds the text of a request from an operation's own documented method, path and example values, for you to run with your own tools and your own key.
- It is a fixed example: the operation's own documented Idempotency-Key example from our OpenAPI document where it has one, and otherwise the example our idempotency guide uses. Either way it stands in for the key your own client has to generate per real request with crypto.randomUUID() or an equivalent - never a value this page expects you to actually reuse against a live request.
- So the snippet's URL is one that would actually resolve rather than a template with a literal brace in it - the value filled in is the parameter's own documented example from our OpenAPI document, not a guess about a real record on your account.
- Only operations our OpenAPI document actually describes are offered, since a snippet for anything else would have no documented parameters or examples to build from - the full set this page can choose from is exactly the set our API docs themselves cover.
Use it from the API
The same check, as one request.