Docs / API reference

API reference

The Medifontis API is a read-only REST API. Every endpoint is a GET under one host that returns JSON.

Base URL

https://api.medifontis.com/v1

Send your key as Authorization: Bearer or as X-Api-Key, never both. Authentication.

country string: Two-letter country code of the source.
sourceId string: The source the record comes from, such as it.aifa.packages.
id string: The record’s identity within its source. Stable across collections.
kind string: The kind of record within the source, such as packages, ingredients or veterinary-medicines.
name string: The record’s display name: its first name.
names string[]: Every name the record can be found by, from its own fields.
identifiers object[]: Typed identifiers as { scheme, value }, such as aic, cn, ndc-package or din. Values are always strings.
data object: The normalized fields of the source, plus useDomain and targetSpecies with their evidence.
region string | null: A sub-national region when the source is regional, otherwise null.
retrievedAt string: ISO 8601 time the record was collected from its source.
sourceUrl string: The official dataset the record was collected from.
licence object: The source’s licence: id, url and the attribution text to display.
limitations string[]: What the source does not establish, such as current marketing or patient eligibility.

Errors answer a status code and a JSON body with an error message. Errors and rate limits.

The version is part of the path. New optional fields and parameters can appear within v1, so ignore fields you do not know.

The complete contract is an OpenAPI 3.1 document you can load into any client generator or API tool. /openapi.json