CIMA REST API — Postman Collection

Postman collection for the CIMA REST API published by the Spanish Medicines and Medical Devices Agency (AEMPS). CIMA (Centro de Información online de Medicamentos) is the official registry of medicines authorized in Spain.

All requests were tested against the live API. Descriptions are in English; original Spanish field names are documented throughout.

Contents

File	Description
CIMA_REST_API.postman_collection.json	Postman collection v2.1 — 43 requests across 11 folders
er_diagram.md	Mermaid entity-relationship diagram of all API data types with Spanish→English name mapping
CIMA_REST_API.md	API reference converted from the official PDF via markitdown

Collection Overview

Folder	Requests	Description
Medicines	10	Search by name, active ingredient, ATC code, flags (biosimilar, orphan, narcotic); get single medicine by registration number or national code; full-text search in technical data sheets
Presentations	3	List and get individual packaged forms of a medicine
Supply Problems	2	Active shortage alerts across all medicines or by national code
Clinical Description / VMP-VMPP	2	Brand-agnostic clinical descriptors grouped by substance and dose
Safety Notes	2	Official AEMPS safety communications per medicine
Safety Materials	2	Patient and professional informational documents per medicine
Master Data	6	Reference tables: active ingredients, pharmaceutical forms, administration routes, laboratories, ATC codes
Change Log	3	Track medicines added, removed, or modified since a given date
Segmented Documents	5	Section-by-section content of technical sheets and prospectuses (JSON or HTML)
Photos	4	Thumbnail and full-resolution packaging and pharmaceutical form images
HTML Documents	4	Full technical sheets and prospectuses as rendered HTML pages

Quick Start

1. Import CIMA_REST_API.postman_collection.json into Postman
2. No authentication required — the API is public and unauthenticated
3. All requests use collection variables pre-filled with working examples:
   • baseUrl = https://cima.aemps.es/cima/rest
   • exampleNregistro = 51347 (Aspirina C 400mg)
   • exampleNregistroNotes = 88019 (Clozapina Stada — has safety notes and materials)
   • exampleCn = 658680 (national code example)

Data Model

See er_diagram.md for the full entity-relationship diagram including:

• All 17 entities with English field names
• Complete Spanish → English name mapping tables (entities + fields)
• Relationship cardinalities
• Per-entity notes on endpoint, caveats, and undocumented behavior found during testing

API Base URL

https://cima.aemps.es/cima/rest/

All responses are JSON encoded in UTF-8. Dates use Unix Epoch (POSIX Time) GMT+2. Paginated endpoints accept a pagina query parameter.

Known API Quirks

Discovered by testing against the live API — not documented in the official PDF:

Endpoint	Quirk
GET /registroCambios	Response field is cambio (not cambios as the PDF states)
GET /maestras	Requires at least one filter (nombre, id, or codigo) — returns HTTP 204 with no body if omitted
GET /maestras?maestra=7	The codigo filter is silently ignored — always use nombre to search ATC codes
GET /materiales/:nregistro	Returns a single object {listaDocsPaciente, listaDocsProfesional}, not an array
GET /notas/:nregistro	Returns [] for medicines without notes — check the notas boolean flag on the medicine first
fotos[].url	Always a thumbnail (~4.5 KB). Replace thumbnails with full in the path for full resolution (~400 KB)

Source

• Official API documentation: CIMA REST API PDF
• CIMA portal: cima.aemps.es
• API version documented: v1.23