# The Dosidal API.

The signed record of prescription medicines over plain HTTPS and JSON. Read-only. No sign-in, no account. Every answer carries its source, its read date, its signature and a receipt.


## What it answers

- **lookup** — Look up a medicine by code, or by name or substance exactly as published, with any of market, maker, strength, form and pack size. Returns one signed record, or the candidates and the fields in which they differ, or N/A. Exact matching only.
- **get_record** — Return the current signed record, every field with its source page, read date and state.
- **related_records** — Return records related to this one in other markets, each labelled "same product" or "same substance, strength and form". A link does not say one product can be used in place of another.
- **list_events_since** — Return change events from a given point.
- **get_checkpoint** — Return the signed checkpoint of a market's event chain.
- **verify_record** — Check a record's signature under the keyring.
- **list_markets** — Return the markets on the record, each with its authority and its counts.
- **get_market** — One market served: its record and event counts, its chain checkpoint and its part hashes.
- **get_keyring** — The public keys (the record key; one RCO key per receipt chain; ES256, P-256) and exactly how to check a receipt and a record with them.
- **lookup_gtin** — The presentation records a GTIN anchors in the markets served, signed.
- **check_gtin** — Check a GTIN's check digit and whether it is a restricted-circulation number.
- **verify_receipt** — Check a receipt's hash, signature and chain position. Requires no credential and writes no receipt.

## Routes

- `GET https://dosidal-api.ai/v1/lookup` — The lookup: give code, or name or substance exactly as published, with optional market, maker, strength, form, pack_size. One record, or candidates with differs_in and pages, or N/A. Any other parameter is a typed error.
- `GET https://dosidal-api.ai/v1/packs/{code}` — A whole GTIN, national pack code or authorisation number.
- `GET https://dosidal-api.ai/v1/records/{record_id}` — One signed record, current or as of a date.
- `GET https://dosidal-api.ai/v1/related/{record_id}` — Related records in other markets, each link labelled "same product" (EU central number or published GTIN) or "same substance, strength and form", with its basis. A link shows how two records are related. It does not say one product can be used in place of another.
- `GET https://dosidal-api.ai/v1/markets` — The markets served, with record counts.
- `GET https://dosidal-api.ai/v1/markets/{code}` — One market served: counts, checkpoint and part hashes.
- `GET https://dosidal-api.ai/v1/events/{market}` — One market's change feed after a sequence number, with its signed chain checkpoint.
- `GET https://dosidal-api.ai/v1/checkpoints/{market}` — One market's signed chain checkpoint.
- `GET https://dosidal-api.ai/v1/keyring` — The public keys and how to check a receipt and a record.
- `GET https://dosidal-api.ai/v1/gtin/{gtin}` — The presentation records a GTIN anchors.
- `GET https://dosidal-api.ai/v1/gtin/{gtin}/check` — A GTIN's check digit and restricted-circulation test.
- `POST https://dosidal-api.ai/v1/verify/record` — Check a record's signature against the keyring. Send the record as the body.
- `POST https://dosidal-api.ai/v1/verify/receipt` — Check a receipt. Send {"receipt": ..., "response": ...}; the response is optional. Writes no receipt.
- [OpenAPI](https://dosidal-api.ai/openapi.json)
- [API catalog](https://dosidal-api.ai/.well-known/api-catalog)

## Connect

- **MCP** — `https://mcp.dosidal-api.ai/mcp`
- **Transport** — streamable HTTP
- **Sign-in** — none

```
{
 "mcpServers": {
  "dosidal": {
   "url": "https://mcp.dosidal-api.ai/mcp"
  }
 }
}
```

## Machine kit

- [/llms.txt](/llms.txt)
- [/index.md](/index.md)
- [/robots.txt](/robots.txt)
- [/sitemap.xml](/sitemap.xml)
- [/.well-known/agent-card.json](/.well-known/agent-card.json)
- [/.well-known/mcp.json](/.well-known/mcp.json)
- [/.well-known/jwks.json](/.well-known/jwks.json)
- [/.well-known/security.txt](/.well-known/security.txt)
- [/.well-known/poppy.json](/.well-known/poppy.json)
- [/dose.json](/dose.json)
- [/nodes.json](/nodes.json)
- [/openapi.json](/openapi.json)
- [/.well-known/api-catalog](/.well-known/api-catalog)

## Contact

Contact: the form at the bottom of https://dosidal-api.ai/#contact

---
Dosidal is a product record. It identifies a medicine and its regulatory status. It does not advise on use.
Artificial intelligence makes mistakes. Dosidal is an information source, not a recommendation. Read the regulator.
Dosidal is operated by Dosidal AI Corp. Office: 6687 Nelson Avenue, Suite 304, West Vancouver, BC V7W 2B2, Canada.
© 2027 Dosidal AI Corp.
Dosidal · dosidal-api.ai · Surface 1.0 (2026-11-16)
