Interested in joining a scientific study?Learn more

API conventions

Use one predictable API contract.

All available Public APIs use the same version header, request id header, success envelope, error envelope and rate-limit header names.

Versioned contract

Send mymolecules-api-version: 2026-07-10 on every documented Public API request. Responses then use data/meta for success and error/meta for errors.

{
  "data": {},
  "meta": {
    "request_id": "req_...",
    "api_version": "2026-07-10"
  }
}

Request ids

You may send x-request-id. If you do not, the API returns one. Log the returned x-request-id when investigating production issues.

Public surface

The public reference covers only documented third-party integration endpoints. App, webhook and internal functions use internal standards but are not listed as public developer APIs.