Skip to content
GET /v1/meta

Supported versions & inputs

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/openapi-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/openapi-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/openapi-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/openapi-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/openapi-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "Validate and summarise an OpenAPI / Swagger API definition. Supply the spec inline via ?spec=, as a POST body, or fetched from a ?url= (JSON or YAML; private targets refused). /v1/validate detects the version (Swagger 2.0, OpenAPI 3.0.x or 3.1.x), checks the required structure (info.title/version, paths/components, every operation's responses), lints for common problems (duplicate or missing operationIds, missing summaries, undeclared tags, malformed paths) and returns valid plus counts of paths, operations, schemas, tags and servers with separate error and warning lists. /v1/summary inventories the API: every endpoint with its method, path, operationId, summary and tags, plus the declared servers, tags and component schemas. Ideal for CI gates on API contracts, API-catalogue ingestion, documentation tooling and design review. An OpenAPI definition validator/linter — distinct from the JSON-Schema validator (jsonschema), the JSON/YAML converters and the on-page SEO/HTML tools. No key, no cache.",
        "input": [
            "?spec= (inline JSON/YAML)",
            "?url= (fetched, SSRF-guarded)",
            "POST body (JSON/YAML)"
        ],
        "supports": [
            "Swagger 2.0",
            "OpenAPI 3.0.x",
            "OpenAPI 3.1.x"
        ],
        "endpoints": [
            "/v1/validate",
            "/v1/summary",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T23:40:50.135Z",
        "request_id": "117e08aa-28fe-467e-b89a-c650beea70fa"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}