{"openapi":"3.1.0","info":{"title":"Dosidal API","version":"1.1.0","description":"The plain web API for Dosidal: the same lookup and record reads as the MCP, over HTTPS and JSON, for clients that do not speak MCP. Dosidal is a product record. It identifies a medicine and its regulatory status. It does not advise on use. Read-only product record: no sign-in, no account, no purchase. Artificial intelligence makes mistakes. Read the regulator.","contact":{"name":"Dosidal contact form","url":"https://dosidal.ai/contact"}},"servers":[{"url":"https://dosidal-api.ai"}],"paths":{"/v1/lookup":{"get":{"operationId":"lookup","summary":"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, or N/A. Any other parameter is a typed error.","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string"}},{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"substance","in":"query","required":false,"schema":{"type":"string"}},{"name":"market","in":"query","required":false,"schema":{"type":"string"}},{"name":"maker","in":"query","required":false,"schema":{"type":"string"}},{"name":"strength","in":"query","required":false,"schema":{"type":"string"}},{"name":"form","in":"query","required":false,"schema":{"type":"string"}},{"name":"pack_size","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The answer, with the scope line, the notice and a signed receipt. Anything not served answers N/A.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/packs/{code}":{"get":{"operationId":"lookup_by_code","summary":"A bare GTIN, national pack code or authorisation number.","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}},{"name":"market","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The answer, with the scope line, the notice and a signed receipt. Anything not served answers N/A.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/records/{record_id}":{"get":{"operationId":"get_record","summary":"One signed record, current or as of a date.","parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"as_of","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The answer, with the scope line, the notice and a signed receipt. Anything not served answers N/A.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/related/{record_id}":{"get":{"operationId":"related_records","summary":"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.","parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"market","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The answer, with the scope line, the notice and a signed receipt. Anything not served answers N/A.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/markets":{"get":{"operationId":"list_markets","summary":"The markets served, with record counts.","parameters":[],"responses":{"200":{"description":"The answer, with the scope line, the notice and a signed receipt. Anything not served answers N/A.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/markets/{code}":{"get":{"operationId":"get_market","summary":"One market served: counts and manifest hashes.","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The answer, with the scope line, the notice and a signed receipt. Anything not served answers N/A.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/events/{market}":{"get":{"operationId":"list_events_since","summary":"One market's change feed after a sequence number, with its signed chain checkpoint.","parameters":[{"name":"market","in":"path","required":true,"schema":{"type":"string"}},{"name":"since_seq","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer, with the scope line, the notice and a signed receipt. Anything not served answers N/A.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/checkpoints/{market}":{"get":{"operationId":"get_checkpoint","summary":"One market's signed chain checkpoint.","parameters":[{"name":"market","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The answer, with the scope line, the notice and a signed receipt. Anything not served answers N/A.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/keyring":{"get":{"operationId":"get_keyring","summary":"The public keys (record key, RCO key).","parameters":[],"responses":{"200":{"description":"The answer, with the scope line, the notice and a signed receipt. Anything not served answers N/A.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/gtin/{gtin}":{"get":{"operationId":"lookup_gtin","summary":"The presentation records a GTIN anchors.","parameters":[{"name":"gtin","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The answer, with the scope line, the notice and a signed receipt. Anything not served answers N/A.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/gtin/{gtin}/check":{"get":{"operationId":"check_gtin_check","summary":"A GTIN's check digit and restricted-circulation test.","parameters":[{"name":"gtin","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The answer, with the scope line, the notice and a signed receipt. Anything not served answers N/A.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/verify/record":{"post":{"operationId":"verify_record","summary":"Check a record's signature against the keyring.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"valid true or false, with a receipt.","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"externalDocs":{"description":"The same engine over MCP","url":"https://mcp.dosidal-api.ai/mcp"}}