BEUDAMED
    API Tools

    BEUDAMED API

    The BEUDAMED API provides JSON access to regulatory search workflows across EU EUDAMED and US FDA data: identifier resolution, dossiers, verification, FDA pathway analysis, and search.

    Get an API key → MCP setup

    Authentication

    Bearer token

    API access requires a bearer token created in your BEUDAMED API dashboard. Send the token in the Authorization header. 

    Authorization: Bearer YOUR_API_TOKEN

    Tokens are shown only once when created. Store them securely. You can revoke old tokens and create new ones from your dashboard.

    MCP Server

    AI connectors

    The MCP endpoint exposes the same regulatory data to AI tools through a read-only Model Context Protocol server. Add https://beudamed.com/mcp as a remote HTTP MCP server; OAuth sign-in is handled by the client.

    Claude
    claude mcp add --transport http beudamed https://beudamed.com/mcp
    Codex
    codex mcp add beudamed --url https://beudamed.com/mcp

    After adding the server, follow the OAuth prompt in your client to authorize BEUDAMED access.

    Resource
    Use
    beudamed://data-coverage
    Current FDA/EUDAMED dataset coverage and limitations.
    beudamed://identifier-guide
    Supported identifiers for resolver and record lookup tools.
    beudamed://record-types
    Supported MCP/API record types and aliases.
    beudamed://fda-product-code-guide
    How to use FDA product codes for predicates, review times, PMAs, and registrations.
    Tool
    Use
    search
    Search records and return refs for fetch.
    fetch
    Fetch a full record by search ref.
    search_regulatory_data
    Paginated FDA/EUDAMED search with filters and aggregations.
    get_record
    Fetch a record by type and identifier.
    find_510k_predicates
    Find likely FDA 510(k) predicates by K-number, product code, or text.
    analyze_510k_review_times
    Compute FDA 510(k) review-time statistics.
    get_manufacturer_profile
    Resolve an EUDAMED manufacturer and summarize related devices and certificates.
    resolve_identifier
    Resolve FDA/EUDAMED identifiers to canonical records.
    get_device_dossier
    Build a device or pathway dossier from related records.
    verify_manufacturer
    Summarize EUDAMED manufacturer status, certificates, devices, and actors.
    verify_certificate
    Summarize EUDAMED certificate validity and related records.
    analyze_fda_product_code
    Analyze FDA classification, predicates, review times, PMAs, and registrations.
    find_similar_devices
    Find advisory EU-US cross-reference candidates.
    compare_regulatory_records
    Compare two record refs without claiming equivalence.

    Workflow Endpoints

    Regulatory research

    Workflow endpoints compose existing BEUDAMED records into research-ready JSON. They are read-only and use the same bearer-token authentication and quota metering as lookup and search endpoints. 

    curl "https://beudamed.com/api/v1/resolve?identifier=K123456" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl "https://beudamed.com/api/v1/device_dossiers/fda_udi/07615208382464" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl "https://beudamed.com/api/v1/cross_references?record_ref=fda_udi:07615208382464&target_provider=eudamed" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
    Endpoint
    Use
    GET /api/v1/resolve?identifier=...
    Resolve UDI-DI, Basic UDI-DI, K-number, product code, SRN, certificate number, and record refs.
    GET /api/v1/records/:type/:id
    Fetch a full regulatory record by type and public identifier.
    GET /api/v1/device_dossiers/:type/:id
    Build a dossier around an EUDAMED device/basic UDI-DI or FDA UDI/pathway record.
    GET /api/v1/manufacturer_profiles/:id
    Verify an EUDAMED manufacturer using linked devices, certificates, notified bodies, ARs, and importers.
    GET /api/v1/certificate_verifications/:id
    Verify an EUDAMED certificate by UUID or certificate number.
    GET /api/v1/fda/product_codes/:code
    Analyze FDA product-code classification, predicates, review times, PMAs, and registrations.
    GET /api/v1/fda/product_codes/:code/predicates
    Return 510(k) predicate candidates for a product code.
    GET /api/v1/fda/product_codes/:code/review_times
    Return 510(k) review-time statistics for a product code.
    GET /api/v1/cross_references?record_ref=...&target_provider=...
    Return advisory EU-US candidate matches with confidence and limitations.

    Cross-reference results are advisory research leads only. They include confidence and match reasons but do not claim regulatory equivalence.

    Lookup FDA UDI by Primary DI

    GET endpoint

    Use this endpoint when you already have an FDA primary device identifier and need the corresponding FDA UDI record as JSON. 

    GET /api/v1/fda_udis/07615208382464
    curl https://beudamed.com/api/v1/fda_udis/07615208382464 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

    The response includes stable top-level fields such as primary_di, brand_name, company_name, identifiers, product codes, GMDN terms, and the original FDA source payload under raw.

    Lookup EUDAMED Device by UDI-DI

    GET endpoint

    Use this endpoint when you have an EUDAMED UDI-DI and need the matching device record. For legacy devices, the same parameter is the EUDAMED ID. 

    GET /api/v1/eudamed_devices/06958481466379
    curl https://beudamed.com/api/v1/eudamed_devices/06958481466379 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

    The response includes stable top-level fields such as primary_di, basic_udi_di, manufacturer, regulation, classification, legacy status, and the original EUDAMED source payload under raw.

    Lookup EUDAMED Basic UDI-DI

    GET endpoint

    Use this endpoint when you have an EUDAMED Basic UDI-DI. For legacy devices this is the EUDAMED DI, commonly represented with a B- prefix. The endpoint also accepts the unprefixed legacy EUDAMED ID and resolves it to the matching B-... record when present. 

    GET /api/v1/eudamed_basic_udi_dis/B-06958481466379
    curl https://beudamed.com/api/v1/eudamed_basic_udi_dis/B-06958481466379 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

    Search

    Paginated JSON

    Use search when users provide a producer, brand, material, model, or other free-text query. The API reuses the same search backend as the website and returns paginated JSON. 

    GET /api/v1/search?q=IPSInLine%20dentin&type=fda_udi&dedupe=primary_di
    curl "https://beudamed.com/api/v1/search?q=IPSInLine%20dentin&type=fda_udi&dedupe=primary_di" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
    curl "https://beudamed.com/api/v1/search?q=ceramic&provider=eudamed" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
    Parameter
    Description
    q
    Search query. Blank queries search all records.
    provider
    Optional source filter. Supported values: fda, eudamed.
    type
    Optional record type filter. Supported values: fda_udi, eudamed_device, eudamed_basic_udi_di.
    page
    Page number. Defaults to 1.
    per_page
    Results per page. Defaults to 10 and is capped at 50.
    dedupe
    Use primary_di to return unique primary DIs within the current result page.