Reagent API

A REST API over the free chemical database — search chemicals, fetch products and their GHS hazards. Read-only, JSON.

Authentication

Every request needs an API key in the X-API-Key header. Create a key (free) in the Developer Console — it's shown once at creation.

curl -H "X-API-Key: cpd_live_your_key" "https://elboneh.com/v1/search?q=acetone"

Get an API key →

Base URL & format

Base URL: https://elboneh.com/v1. All responses are JSON. Errors return an HTTP status with a {"detail": "..."} body.

Status	Meaning
401	Missing / invalid / revoked key
403	Key lacks the required scope
429	Rate limit or daily quota exceeded (see `Retry-After`)

Rate limits

A short-window rate limit per key (smooths bursts).
A daily quota of 5,000 calls per key, resetting at 00:00 UTC.
Track your usage in the Console. Need more? Get in touch.

Endpoints

GET/v1/searchread:search

Full-text search over products. A CAS number, UN number, or H-code routes to an exact match; free text is fuzzy over names, synonyms, and ingredients.

Query param	Description
q	Search text, CAS (`67-64-1`), or hazard code (`H225`)
page, size	Pagination (defaults 1, 20)

curl -H "X-API-Key: KEY" "https://elboneh.com/v1/search?q=toluene"

GET/v1/search/suggestread:search

Type-ahead suggestions.

curl -H "X-API-Key: KEY" "https://elboneh.com/v1/search/suggest?prefix=aceto"

GET/v1/productsread:products

List products, newest first, cursor-paginated. Returns {items, next_cursor}.

Query param	Description
limit	1–200 (default 50)
cursor	Opaque cursor from a prior `next_cursor`

curl -H "X-API-Key: KEY" "https://elboneh.com/v1/products?limit=5"

GET/v1/products/{id}read:products

A product and its active version — identity, GHS signal word / pictograms / H-statements, composition (CAS + concentration), and the source SDS link.

curl -H "X-API-Key: KEY" "https://elboneh.com/v1/products/<uuid>"

GET/v1/products/{id}/versionsread:products

Every SDS revision we've captured for a product (append-only version history).

No-key endpoints

The free web search is also directly callable without a key (IP rate-limited): /v1/public/search?q=, /v1/public/substances/{cas}, and /v1/public/stats. The keyed API above adds product detail, version history, suggestions, and higher limits.