Test environment
Run the complete Openhandle API against deterministic synthetic data with a $0.000 actual charge.
Make this request first:
curl "https://api.openhandle.dev/v1/instagram/profiles/@northstar_forge_test" \
-H "Authorization: Bearer $OPENHANDLE_TEST_KEY"A Test API key selects a safe synthetic data universe. It starts with
oh_test_. The key, not a username, header, query parameter, or tool argument,
selects the environment.
Test and Live use the same routes, parameters, response schemas, pagination,
and error handling. A test request still passes through authentication,
validation, rate limits, request history, pricing, and immutable usage logging.
The actual charge is always $0.000 and the normal live-equivalent price is
recorded separately.
Test requests never call an external data service. They do not consume an allowance, move a live price band, increase spend or exposure, or enter an invoice.
Response metadata
An answered test request includes these headers:
| Header | Meaning |
|---|---|
Openhandle-Environment: test | The Test environment answered the request. |
Openhandle-Cost: 0.000 | Authoritative actual charge. |
Openhandle-List-Price | Price of the equivalent Live request. |
Openhandle-Billing-Disposition: test | The request is excluded from billing. |
Openhandle-Dataset-Version | Exact synthetic dataset used. |
X-Request-ID | Identifier used in Requests and Usage. |
Openhandle-Source remains live or cache. In Test, live means a fresh
synthetic read. It does not mean that Openhandle contacted an external service.
Start here
- Create a Test API key.
- Find a documented synthetic record.
- Call a normal endpoint or use the dashboard Playground in Test mode.
- Inspect the request and its
$0.000charge in Requests or Usage.
No email verification, payment method, or free Live request is required for this flow.