French Medicines APIAPI Médicaments FR

API Médicaments FRFrench Medicines API

APIDiscovered1/7blocked by verifiedPreviewSubscribe🇫🇷France

This RESTful API provides programmatic access to comprehensive data on French medicines drawn from the Base de Données Publique des Médicaments (BDPM), the public medicines database. It allows searching for medicines by name, CIS code, or CIP code, retrieving information on generics, and accessing detailed drug records. The API is freely accessible without authentication and is aimed at developers and health-related applications needing structured, up-to-date medicinal product data for France, covering marketing authorizations, packaging identifiers, and related regulatory information.Cette API RESTful fournit un accès programmatique aux données complètes des médicaments français issues de la Base de Données Publique des Médicaments (BDPM). Elle permet de rechercher des médicaments par nom, code CIS ou CIP, d'obtenir des informations sur les génériques, et d'accéder à l'ensemble…

educationlegislation

OpenAPI spec Read the docs Visit homepage

Trust score

How is this computed?

good

Weighted across five axes. Tap a ring for what it measures.

Data schema (67 fields)

Filterable via the API (11)

pagepageSizesearchcipcislibellegroupgroupIDpageNumberelementgroupId

Field	Type	Description
page	integer	Page number for paginated results, 10 items per page by default.Numéro de page (pagination à 10 éléments par page par défaut, utilisable avec pageSize)
pageSizePage size	integer	Number of items per page, ranging from 1 to 200.Nombre d'éléments par page. Plage valide: 1-200. Valeur par défaut: 10 éléments. Doit être utilisé avec le paramètre page (mutuellement exclusif avec search/cip/libelle).
search	string	Multi-word search term (1-6 words) combined with AND logic.Terme de recherche multi-mots (1-6 mots requis, logique ET). Les mots sont séparés par + ou espace dans l'URL. Minimum 3 caractères, maximum 50 caractères. Maximum 250 résultats par recherche (retourne 429 si dépassé).
cip	string	CIP7 or CIP13 code identifying a drug presentation.Code CIP (CIP7 ou CIP13)
cis	string	CIS code identifying a drug.Code CIS
libelle	string	Multi-word search term (1-6 words) for drug names, combined with AND logic.Terme de recherche multi-mots (1-6 mots requis, logique ET). Les mots sont séparés par + ou espace dans l'URL. Minimum 3 caractères, maximum 50 caractères. Maximum 100 résultats par recherche (retourne 429 si dépassé). Note: Les données source BDPM sont en majuscules sans accents (ex: PARACETAMOL).
group	integer	Positive integer identifier of a generic drug group.ID de groupe (entier positif)
groupIDGroup id	integer	Positive integer identifier of a generic drug group, below 100,000.ID de groupe (entier positif inférieur à 100 000)
pageNumberPage number	integer	Page number for paginated results.Numéro de page
element	string	Search term for a pharmaceutical element, 3-50 characters.Terme de recherche (3-50 caractères, lettres, chiffres, espaces, et caractères spéciaux autorisés)
groupIdGroup id	integer	Positive integer identifier of a generic drug group, below 100,000.ID de groupe (entier positif inférieur à 100 000)
dataPaginatedMedicament	array<object>	List of drug (medicament) records returned by the query.List of drug (medicament) records returned by the query.
totalItemsPaginatedMedicament	integer	Total number of items matching the query.Total number of items matching the query.
maxPagePaginatedMedicament	integer	Highest page number available for the current query.Highest page number available for the current query.
elementPharmaceutiqueMedicament	string	Pharmaceutical element or active substance category of the drug.Pharmaceutical element or active substance category of the drug.
formePharmaceutiqueMedicament	string	Pharmaceutical form of the drug, e.g. tablet or solution.Pharmaceutical form of the drug, e.g. tablet or solution.
voiesAdministrationMedicament	array<string>	List of administration routes for the drug.List of administration routes for the drug.
statusAutorisationMedicament	string	Marketing authorization status of the drug.Marketing authorization status of the drug.
typeProcedureMedicament	string	Type of authorization procedure used for the drug.Type of authorization procedure used for the drug.
etatComercialisationMedicament	string	Current commercialization status of the drug.Current commercialization status of the drug.
dateAMMMedicament	string (date)	Date the marketing authorization (AMM) was granted.Date the marketing authorization (AMM) was granted.
titulaireMedicament	string	Name of the marketing authorization holder.Name of the marketing authorization holder.
surveillanceRenforceeMedicament	string	Indicates whether the drug is under additional monitoring.Indicates whether the drug is under additional monitoring.
compositionMedicament	array<object>	List of the drug's active substance compositions.List of the drug's active substance compositions.
generiquesMedicament	array<object>	List of generic drug entries linked to this drug.List of generic drug entries linked to this drug.
presentationMedicament	array<object>	List of packaging presentations available for the drug.List of packaging presentations available for the drug.
conditionsMedicament	array<string>	List of prescription or dispensing conditions for the drug.List of prescription or dispensing conditions for the drug.
cip7PresentationResponse	string	7-digit CIP code identifying the drug presentation.7-digit CIP code identifying the drug presentation.
statusAdministratifPresentationResponse	string	Administrative status of the drug presentation.Administrative status of the drug presentation.
dateDeclarationPresentationResponse	string (date)	Date the presentation was declared for commercialization.Date the presentation was declared for commercialization.
cip13PresentationResponse	string	13-digit CIP code identifying the drug presentation.13-digit CIP code identifying the drug presentation.
agreementPresentationResponse	string	Approval status for collective use (hospitals) of the presentation.Approval status for collective use (hospitals) of the presentation.
tauxRemboursementPresentationResponse	string	Reimbursement rate applicable to the presentation.Reimbursement rate applicable to the presentation.
prixPresentationResponse	number (float)	Price of the drug presentation.Price of the drug presentation.
medicamentsGeneriqueListResponse	array<object>	List of drugs belonging to the generic group.List of drugs belonging to the generic group.
orphanCISGeneriqueListResponse	array<integer>	CIS codes referenced in the generic group without matching drug records.Liste des codes CIS référencés dans le groupe générique mais sans entrée médicament correspondante dans la base de données. Ces CIS n'ont pas de données détaillées disponibles (composition, forme pharmaceutique, type, etc.). Peut être : - Un tableau d'entiers : [61586325, 60473805] - Null : null (si
errorErrorResponse	string	Short error identifier returned by the API.Short error identifier returned by the API.
messageErrorResponse	string	Human-readable error message returned by the API.Human-readable error message returned by the API.
codeErrorResponse	integer	Numeric error code returned by the API.Numeric error code returned by the API.
codeSubstanceCompositionItem	string	Code identifying the active substance.Code identifying the active substance.
denominationSubstanceCompositionItem	string	Name of the active substance.Name of the active substance.
dosageCompositionItem	string	Dosage amount of the substance in the composition.Dosage amount of the substance in the composition.
referenceDosageCompositionItem	string	Reference basis for the dosage value.Reference basis for the dosage value.
natureComposantCompositionItem	string	Nature of the component, e.g. active or excipient.Nature of the component, e.g. active or excipient.
typeGeneriqueMedicament	string	Type of the generic drug entry, e.g. reference or generic.Type of the generic drug entry, e.g. reference or generic.
substanceGeneriqueCompositionItem	string	Name of the active substance in the generic composition.Name of the active substance in the generic composition.
statusHealthResponse	string	Overall health status of the API service.Overall health status of the API service.
last_updateHealthDataResponse	string (date-time)	Timestamp of the last data update.Timestamp of the last data update.
data_age_hoursHealthDataResponse	number (float)	Age of the current dataset in hours since last update.Age of the current dataset in hours since last update.
is_updatingHealthDataResponse	boolean	Indicates whether a data update is currently in progress.Indicates whether a data update is currently in progress.
timestampDiagnosticsResponse	string (date-time)	Timestamp when the diagnostics response was generated.Timestamp when the diagnostics response was generated.
uptime_secondsDiagnosticsResponse	number (float)	Number of seconds the service has been running.Number of seconds the service has been running.
next_updateDiagnosticsResponse	string (date-time)	Timestamp of the next scheduled data update.Timestamp of the next scheduled data update.
systemDiagnosticsResponse	object	System-level performance metrics for the service.System-level performance metrics for the service.
data_integrityDiagnosticsResponse	object	Summary of data integrity checks on the dataset.Summary of data integrity checks on the dataset.
goroutinesSystemMetrics	integer	Number of active goroutines in the running service.Number of active goroutines in the running service.
memorySystemMetrics	object	Memory usage metrics for the service.Memory usage metrics for the service.
alloc_mbMemoryMetrics	integer	Amount of memory currently allocated, in megabytes.Amount of memory currently allocated, in megabytes.
sys_mbMemoryMetrics	integer	Total system memory obtained by the process, in megabytes.Total system memory obtained by the process, in megabytes.
num_gcMemoryMetrics	integer	Number of garbage collection cycles executed.Number of garbage collection cycles executed.
medicaments_without_conditionsDataIntegrityResponse	object	Metric on drugs missing prescription condition data.Metric on drugs missing prescription condition data.
medicaments_without_generiquesDataIntegrityResponse	object	Metric on drugs missing linked generic entries.Metric on drugs missing linked generic entries.
medicaments_without_presentationsDataIntegrityResponse	object	Metric on drugs missing presentation data.Metric on drugs missing presentation data.
medicaments_without_compositionsDataIntegrityResponse	object	Metric on drugs missing composition data.Metric on drugs missing composition data.
generique_only_cisDataIntegrityResponse	object	Metric on CIS codes present only in generic groups.Metric on CIS codes present only in generic groups.
countIntegrityMetric	integer	Number of records matching the integrity metric.Number of records matching the integrity metric.
sample_cisIntegrityMetric	array<integer>	Sample list of CIS codes for the integrity metric.Sample list of CIS codes for the integrity metric.

Schema captured from openapi 1 month ago.

Verification Status

Using the API

Configuration

Base URL: https://medicaments-api.giygas.dev
Format: openapi

License

Terms stated by the source (not a recognized license):

https://www.gnu.org/licenses/agpl-3.0.html

Query examples

curl -s 'https://medicaments-api.giygas.dev/docs/openapi.yaml' -H 'Accept: application/json'

Machine-readable API description (use it to generate clients).

Full API documentation ↗

Machine-readable & source

OpenAPI spec JSON

Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.