---
title: "Search EU Union Register"
method: GET
path: "/v1/sources/eu-union-register/search"
tags: ["EU Union Register"]
---

# Search EU Union Register

`GET /v1/sources/eu-union-register/search`

## Request

- Base URL: `https://api.assyro.com`
- URL: `https://api.assyro.com/v1/sources/eu-union-register/search`
- Auth: none declared

Search the European Commission's Union Register of medicinal products, as of Assyro's daily copy of the dataset the Commission publishes. Collections: human-medicines (centrally authorised human medicines, EU/1 numbers), veterinary-medicines (centrally authorised veterinary medicines, EU/2), orphan-designations (the Community Register of orphan medicinal products, EU/3, with each orphan market exclusivity as the register states it) and national-procedures (Commission decisions on nationally authorised products after a referral). Each record carries its EU number, its status in the Commission's words (Active, Withdrawn, Expired / Sunset clause, Refused, Not renewed, Revoked, Suspended), the authorisation (or designation) date, the last decision date, the holder or sponsor and the register page. Use it for whether and when the Commission authorised or designated something, and for orphan market exclusivity start, paediatric extension and end. It is not the national (member-state) registers and does not cover SPCs or patents; calculated regulatory data protection dates are in search_eu_regulatory_protection. Call read_eu_union_register_record for every fact and the Commission decision numbers.

## Query parameters

- `query` string, required: Words in the name, substance, holder, indication or EU number, e.g. "Adcetris", "brentuximab vedotin", "EU/3/08/595". "quoted phrases", OR and -exclusions work.
- `collections` string[]: Keep only these collections (any of them). Omit to search all.
- `dateFrom` string: Earliest authorisation or designation date (the last decision date for an entry without one), YYYY, YYYY-MM or YYYY-MM-DD, inclusive.
- `dateTo` string: Latest such date, YYYY, YYYY-MM or YYYY-MM-DD (inclusive: "2024" means through 2024-12-31).
- `sort` 'relevance' | 'newest': 'relevance' (default) or 'newest' (latest authorisation or designation first).
- `limit` integer: Records to return, default 8.
- `offset` integer: Skip this many results (for paging), default 0.

## Response `200`

Matching records.

- SearchResponse
  - `version` unknown, required
  - `source` SourceRef, required
    - `id` string, required
    - `label` string, required
    - `authority` string, required
  - `total` integer, nullable, required: Total matches the source reports, when it says.
  - `records` Record[], required
    - `id` string, required: The source's own identifier for the record.
    - `title` string, required
    - `url` string, required: The record's page at the source, to verify it.
    - `authority` string, required: Who published the record.
    - `snippet` string, nullable, required: The part of the record that matched; null where the licence allows only a link.
    - `publishedDate` string, nullable, required
    - `version` string, nullable, required: The edition or revision read.
    - `fields` object, nullable, required: The source's own fields; null where the licence allows only a link.
    - `asOf` string, nullable, required: The day Assyro's copy of the source was read (YYYY-MM-DD).
    - `attribution` string: The attribution the source's licence requires, on sources that require one.
  - `note` string
  - `summary` string[]

## Other responses

- `400`: The request is not valid: an unknown parameter or an argument the source refuses.
- `404`: No such source or record.
- `429`: Rate limited; retry after the Retry-After header.
- `503`: The source cannot answer from Assyro's copy right now.

---

[API](https://skmtc.dev/assyro/apis/assyro-public-data-api.md) - [All operations](https://skmtc.dev/assyro/apis/assyro-public-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/assyro/apis/assyro-public-data-api/revisions/c861290c9f47?raw)
