API reference

Base URL: https://api.cyberrxn.com. Authenticate with Authorization: Bearer $CYBERRXN_API_KEY. First-party session and reviewer-only operations have additional restrictions described below.

Download the full OpenAPI contract. The JSON schema is authoritative; field identifiers remain in English in every locale.

Usage and billing · Structured errors

Operation	Details
`GET /v1/stats`	Corpus size and coverage
`POST /v1/reactions/search`	Search observations by structures and condition filters
`POST /v1/reactions/lookup`	Observations of the same canonical transformation
`GET /v1/observations/{observation_id}`	One observation with provenance and checks
`GET /v1/observations/{observation_id}/graph`	Reaction, compound and condition nodes of one observation
`POST /v1/products/similar`	Reactions with structurally similar products
`POST /v1/molecules/reactions`	Observations where a molecule takes part
`POST /v1/chemistry/validate`	Validate reaction records and complete atom conservation
`POST /v1/chemistry/balance`	Balance supplied species or explicitly request optional SynRBL
`POST /v1/chemistry/convert`	Readable chemical formulas, equations and optional InChI
`POST /v1/chemistry/convert-representation`	Convert explicit molecular and reaction formats
`GET /v1/me`	Signed-in user and account
`GET /v1/usage`	Calls in a billing period
`GET /v1/limits`	Workspace spending policies
`PUT /v1/limits`	Set or remove a scoped spending policy
`GET /v1/key-limits`	API key quotas and current usage windows
`PUT /v1/key-limits`	Set or remove a key quota for a calendar or custom period
`GET /v1/rate-limit`	Workspace request rate and latest increase request
`POST /v1/rate-limit-requests`	Ask an operator to approve a higher request rate
`GET /v1/connections`	OAuth clients (ChatGPT, Claude, …) connected to this account
`DELETE /v1/connections/{connection_id}`	Disconnect an OAuth client
`POST /v1/reports`	Report a source-backed observation issue
`GET /v1/reports`	List reports visible to this workspace or staff reviewer
`GET /v1/reports/{report_id}`	Read one report and its review state
`POST /v1/reports/{report_id}/review`	Review a report and optionally approve a typed overlay
`POST /v1/contributions`	Submit a source-backed reaction for human validation
`GET /v1/contributions`	List this workspace's contributions
`GET /v1/contributions/{contribution_id}`	Read one contribution and its validation/reward state
`POST /v1/contributions/{contribution_id}/review`	Independently review a contribution for the shared corpus
`GET /v1/curation/export`	Export durable reviewed corrections and accepted contributions
`GET /v1/skills/reaction-evidence`	Read the current chemistry guide and live action schemas