MVX API

Look up MVX vaccine manufacturer codes from the CDC.

Overview

MVX (Manufacturers of Vaccines) codes identify vaccine manufacturers. These codes are used in conjunction with CVX codes to uniquely identify vaccine products.

Endpoints

Method	Path	Description
GET	`/v1/mvx/:code`	Single MVX lookup
POST	`/v1/mvx/_batch`	Batch lookup (up to 100)
GET	`/v1/mvx/shapes`	List available response shapes

Single Lookup

Look up Pfizer vaccine manufacturer

Request

curl -X GET "https://api.fhirfly.io/v1/mvx/PFR" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

JSON

{
  "data": {
    "code": "PFR",
    "code_system": "http://hl7.org/fhir/sid/mvx",
    "display": "Pfizer, Inc",
    "fhir_coding": {
      "code": "PFR",
      "display": "Pfizer, Inc",
      "system": "http://hl7.org/fhir/sid/mvx"
    },
    "last_updated_by_cdc": "2020-10-30",
    "manufacturer_name": "Pfizer, Inc",
    "notes": "COVID-19 vaccine in co-development with BioNTech. Pfizer includes Wyeth-Lederle Vaccines and Pediatrics, Wyeth Laboratories, Lederle Laboratories, and Praxis Biologics",
    "status": "active"
  },
  "meta": {
    "legal": {
      "attribution_required": false,
      "citation": "CDC National Center for Immunization and Respiratory Diseases. Accessed 2026-01-14 via FHIRfly.",
      "license": "public_domain",
      "source_name": "CDC Immunization"
    }
  }
}

Common MVX Codes

Code	Manufacturer
PFR	Pfizer, Inc
MOD	Moderna US, Inc
JSN	Janssen Products, LP
SKB	GlaxoSmithKline
MSD	Merck Sharp & Dohme

Batch Lookup

Look up multiple MVX codes in a single request (up to 100):

Look up multiple manufacturers

Request

curl -X POST "https://api.fhirfly.io/v1/mvx/_batch" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "codes": [
      "PFR",
      "MOD",
      "SKB"
    ]
  }'

Response

JSON

{
  "data": {
    "found": 3,
    "not_found": 0,
    "results": [
      {
        "code": "PFR",
        "data": {
          "display": "Pfizer, Inc",
          "status": "active"
        }
      },
      {
        "code": "MOD",
        "data": {
          "display": "Moderna US, Inc",
          "status": "active"
        }
      },
      {
        "code": "SKB",
        "data": {
          "display": "GlaxoSmithKline",
          "status": "active"
        }
      }
    ]
  }
}

Response Shapes

Control the level of detail in responses with the shape query parameter:

Shape	Description
`compact`	Code, display, status
`standard`	+ manufacturer_name, notes, fhir_coding
`full`	+ ingest metadata

# Minimal data
GET /v1/mvx/PFR?shape=compact

# Standard data (default)
GET /v1/mvx/PFR?shape=standard

# Full data with provenance
GET /v1/mvx/PFR?shape=full

See Response Shapes for field details.

Required Scopes

mvx:read - Single lookups
mvx:batch - Batch lookups