Reference
Get this OpenAPI document
GET /v1/openapi.json. This document: OpenAPI 3.1 with x-cost-credits and x-free on every operation, generated from the same schemas as the MCP tools.
GET /v1/openapi.json
This document: OpenAPI 3.1 with x-cost-credits and x-free on every operation, generated from the same schemas as the MCP tools.
| Property | Value |
|---|---|
| Endpoint | GET https://mydatahub.emailmovers.com/v1/openapi.json |
| Operation id | getOpenApiDocument |
| Cost | Free (0 credits) |
| Access | No account, key or token needed. |
| Tag | Meta |
Request
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
MyDataHub-Version | header | string | no | The dated API version, pinned per key when left out. Non-breaking changes ship as new dates; the path major changes only for breaking changes, with a 12 month deprecation window. |
Example request
curl "https://mydatahub.emailmovers.com/v1/openapi.json"Responses
200: The OpenAPI document.
Headers: RateLimit, RateLimit-Policy.
Example response
{
"openapi": "3.1.1",
"info": {
"title": "MyDataHub API",
"version": "2.0.0"
}
}Errors
Every error is a problem object with a code and a next_step. Every response carries the RateLimit and RateLimit-Policy headers; see Rate limits.
| Status | Problem codes | When |
|---|---|---|
| 400 | invalid-request, idempotency-key-required, unsupported-version | The request could not be read, or an Idempotency-Key is missing. |
| 429 | rate-limited | Too many requests. Wait for Retry-After. |
| Any other failure | internal-error, service-unavailable, tps-screen-expired | Something failed on our side (500 internal-error) or the service is briefly unavailable (503 service-unavailable, with Retry-After). Nothing was charged; retry with the same Idempotency-Key. A count, sample, quote or order with telephone in play is also refused with 503 tps-screen-expired, with no Retry-After, while the dataset version's TPS and CTPS screen is more than 28 days old. |