Skip to content
ecdsa.com

API

This specification

GEThttps://ecdsa.com/api/v1/openapi.json

The OpenAPI 3.1 document of this API, generated from the same operation definitions the server runs. The same document for every caller: cached by the CDN for an hour, not rate limited.

API key
Not read: the answer is the same for everyone
Rate limit
None: served from the CDN cache

Request

This operation takes no input.

Responses

200OpenAPI 3.1 document.

FieldTypeRequiredDescription
openapistringyes

The OpenAPI version, "3.1.0".

infoobjectyes
  • more members may appear
info.titlestringyes
info.versionstringyes
pathsobjectyes
  • any member names
StatusMeaningCodes
404Not found.
405Method not allowed.
500Internal server error.

Every error answer carries the JSON envelope; the error table says what each code means and what to do.

Example

The OpenAPI document

curl
curl -sS 'https://ecdsa.com/api/v1/openapi.json'
JavaScript (fetch)
const response = await fetch("https://ecdsa.com/api/v1/openapi.json");
console.log(response.status, await response.json());
Python (httpx)
import httpx

response = httpx.get("https://ecdsa.com/api/v1/openapi.json", timeout=30.0)
print(response.status_code, response.json())

The 200 answer is 109 KB of JSON, too long to show here: open it.

The API’s answer to this example, produced for this page on October 20, 2026; relative times and day counts in it refer to that day.

Error codes

CodeStatusMeaning
not_found404No operation exists at this path.
method_not_allowed405The path exists but does not accept this HTTP method; see the Allow header.
internal_error500Unexpected server error.

Schemas

Error

The error envelope of every non-2xx response.

FieldTypeRequiredDescription
errorobjectyes
error.codestringyes

Machine-readable error code. Each response lists the codes it can carry; new codes may be added within v1, so treat an unknown code by its HTTP status.

error.messagestringyes

Human-readable explanation (English).

error.requestIdstringno

The X-Request-Id of this request — quote it when reporting a problem. Sent since v1.1.

error.detailobjectno

Structured context for the error, such as the offending field; omitted when there is none.

  • any member names
error.docsstringno

Where the error codes are explained. Sent since v1.1.

  • format uri

All operations are listed in the API reference.