Device Lookup API

GET /devices/lookup

Returns a single device record in either the original XML format that AccessGUDID receives from the FDA, or a JSON version of that record. A device identifier is required to receive a response.

Resource Information

format URL
JSON https://accessgudid.nlm.nih.gov/api/v1/devices/lookup.json
XML https://accessgudid.nlm.nih.gov/api/v1/devices/lookup.xml

Parameters

Either a di or a udi must be provided.
parameter type description
di String The Device Identifier string unique to a specific device
udi String The full Unique Device Identifier string for a device

This calls and uses the Parse UDI API and returns the parsed UDI information in the response headers.
The UDI parameter should be percent-encoded.

Response Headers

These response headers will only appear when providing a udi.
header type description
udi String The full Unique Device Identifier string for a device
issuing_agency String The Issuing Agency of this specific udi
di String The Device Identifier string unique to a specific device
manufacturing_date Date (YYYY-MM-DD) The manufacturing/production date of the device in a normalized date format (if provided in the udi)
expiration_date Date (YYYY-MM-DD) The expiration date of the device in a normalized date format (if provided in the udi)
lot_number String The batch/lot of the device (if provided in the udi)
serial_number String The serial number of the device (if provided in the udi)
mpho_lot_number String The MPHO Lot Number of the device (if provided in the udi and the issuing-agency is ICCBBA)
donation_id String The Donation Identification Number of the device (if provided in the udi and the issuing-agency is ICCBBA)
manufacturing_date_original Date (Misc. formats) The manufacturing/production date of the device as it was provided (if provided in the udi)
manufacturing_date_original_format String The date format of the manufacturing/production date as it was provided (if provided in the udi). This is to assist users who choose to use the manufacturing-date-original date.
expiration_date_original Date (Misc. formats) The expiration date of the device as it was provided (if provided in the udi)
expiration_date_original_format String The date format of the expiration date as it was provided (if provided in the udi). This is to assist users who choose to use the expiration-date-original date.

Examples

JSON: GET with DIhttps://accessgudid.nlm.nih.gov/api/v1/devices/lookup.json?di=08717648200274

{  
    gudid:{  
        device:{  
            deviceRecordStatus:"Published",
            devicePublishDate:"2015-05-08",
            deviceCommDistributionEndDate:null,
            deviceCommDistributionStatus:"In Commercial Distribution",
            identifiers:{  
                identifier:{  
                    deviceId:"08717648200274",
                    deviceIdType:"Primary",
                    deviceIdIssuingAgency:"GS1",
                    containsDINumber:null,
                    pkgQuantity:null,
                    pkgDiscontinueDate:null,
                    pkgStatus:null
                }
            },
            brandName:"XIENCE ALPINE",
            versionModelNumber:"1145350-28",
            catalogNumber:"1145350-28",
            companyName:"ABBOTT VASCULAR INC.",
            deviceCount:"1",
            deviceDescription:"XIENCE Alpine Everolimus Eluting Coronary Stent System 3.50 mm x 28 mm / Over-The-Wire",
            DMExempt:"false",
            premarketExempt:"false",
            deviceHCTP:"false",
            deviceKit:"false",
            deviceCombinationProduct:"true",
            singleUse:"true",
            lotBatch:"true",
            serialNumber:"false",
            manufacturingDate:"false",
            expirationDate:"true",
            donationIdNumber:"false",
            labeledContainsNRL:"false",
            labeledNoNRL:"false",
            MRISafetyStatus:"MR Conditional",
            rx:"true",
            otc:"false",
            contacts:{  
                customerContact:{  
                    phone:"+1(800)227-9902",
                    phoneExtension:null,
                    email:"AV.CUSTOMERCARE@AV.ABBOTT.COM"
                }
            },
            gmdnTerms:{  
                gmdn:{  
                    gmdnPTName:"Drug-eluting coronary artery stent, non-bioabsorbable-polymer-coated",
                    gmdnPTDefinition:"A sterile non-bioabsorbable metal tubular mesh structure covered with a non-bioabsorbable polymer and a drug coating that is designed to be implanted, via a delivery catheter, into a coronary artery (or saphenous vein graft) to maintain its patency typically in a patient with symptomatic atherosclerotic heart disease. The drug coating is slowly released and intended to inhibit restenosis by reducing vessel smooth muscle cell proliferation. Disposable devices associated with implantation may be included."
                }
            },
            productCodes:{  
                fdaProductCode:{  
                    productCode:"NIQ",
                    productCodeName:"Coronary drug-eluting stent"
                }
            },
            deviceSizes:null,
            environmentalConditions:{  
                storageHandling:[  
                    {  
                        storageHandlingType:"Handling Environment Temperature",
                        storageHandlingHigh:{  
                            unit:"Degrees Celsius",
                            value:"30"
                        },
                        storageHandlingLow:{  
                            unit:"Degrees Celsius",
                            value:"15"
                        },
                        storageHandlingSpecialConditionText:null
                    },
                    {  
                        storageHandlingType:"Special Storage Condition, Specify",
                        storageHandlingHigh:{  
                            unit:"",
                            value:""
                        },
                        storageHandlingLow:{  
                            unit:"",
                            value:""
                        },
                        storageHandlingSpecialConditionText:"Store in a dry, dark, cool place. Protect from light. Store at 25 degrees C; excursions between 15 to 30 degrees C permitted."
                    },
                    {  
                        storageHandlingType:"Storage Environment Temperature",
                        storageHandlingHigh:{  
                            unit:"Degrees Celsius",
                            value:"25"
                        },
                        storageHandlingLow:{  
                            unit:"Degrees Celsius",
                            value:"25"
                        },
                        storageHandlingSpecialConditionText:null
                    }
                ]
            },
            sterilization:{  
                deviceSterile:"true",
                sterilizationPriorToUse:"false",
                methodTypes:null
            }
        }
    }
}

XML: GET with UDIhttps://accessgudid.nlm.nih.gov/api/v1/devices/lookup.xml?udi=%3D%2F08717648200274%3D%2C000025%3DA99971312345600%3D>014032%3D%7D013032%26%2C1000000000000XYZ123

<gudid xmlns="http://www.fda.gov/cdrh/gudid">
	<device xmlns="http://www.fda.gov/cdrh/gudid" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
		<deviceRecordStatus>Published</deviceRecordStatus>
		<devicePublishDate>2015-05-08</devicePublishDate>
		<deviceCommDistributionEndDate xsi:nil="true"/>
		<deviceCommDistributionStatus>In Commercial Distribution</deviceCommDistributionStatus>
		<identifiers>
			<identifier>
				<deviceId>08717648200274</deviceId>
				<deviceIdType>Primary</deviceIdType>
				<deviceIdIssuingAgency>GS1</deviceIdIssuingAgency>
				<containsDINumber xsi:nil="true"/>
				<pkgQuantity xsi:nil="true"/>
				<pkgDiscontinueDate xsi:nil="true"/>
				<pkgStatus xsi:nil="true"/>
			</identifier>
		</identifiers>
		<brandName>XIENCE ALPINE</brandName>
		<versionModelNumber>1145350-28</versionModelNumber>
		<catalogNumber>1145350-28</catalogNumber>
		<companyName>ABBOTT VASCULAR INC.</companyName>
		<deviceCount>1</deviceCount>
		<deviceDescription>
			XIENCE Alpine Everolimus Eluting Coronary Stent System 3.50 mm x 28 mm / Over-The-Wire
		</deviceDescription>
		<DMExempt>false</DMExempt>
		<premarketExempt>false</premarketExempt>
		<deviceHCTP>false</deviceHCTP>
		<deviceKit>false</deviceKit>
		<deviceCombinationProduct>true</deviceCombinationProduct>
		<singleUse>true</singleUse>
		<lotBatch>true</lotBatch>
		<serialNumber>false</serialNumber>
		<manufacturingDate>false</manufacturingDate>
		<expirationDate>true</expirationDate>
		<donationIdNumber>false</donationIdNumber>
		<labeledContainsNRL>false</labeledContainsNRL>
		<labeledNoNRL>false</labeledNoNRL>
		<MRISafetyStatus>MR Conditional</MRISafetyStatus>
		<rx>true</rx>
		<otc>false</otc>
		<contacts>
			<customerContact>
				<phone>+1(800)227-9902</phone>
				<phoneExtension xsi:nil="true"/>
				<email>AV.CUSTOMERCARE@AV.ABBOTT.COM</email>
			</customerContact>
		</contacts>
		<gmdnTerms>
			<gmdn>
				<gmdnPTName>
					Drug-eluting coronary artery stent, non-bioabsorbable-polymer-coated
				</gmdnPTName>
				<gmdnPTDefinition>
					A sterile non-bioabsorbable metal tubular mesh structure covered with a non-bioabsorbable polymer and a drug coating that is designed to be implanted, via a delivery catheter, into a coronary artery (or saphenous vein graft) to maintain its patency typically in a patient with symptomatic atherosclerotic heart disease. The drug coating is slowly released and intended to inhibit restenosis by reducing vessel smooth muscle cell proliferation. Disposable devices associated with implantation may be included.
				</gmdnPTDefinition>
			</gmdn>
		</gmdnTerms>
		<productCodes>
			<fdaProductCode>
				<productCode>NIQ</productCode>
				<productCodeName>Coronary drug-eluting stent</productCodeName>
			</fdaProductCode>
		</productCodes>
		<deviceSizes/>
		<environmentalConditions>
			<storageHandling>
				<storageHandlingType>Handling Environment Temperature</storageHandlingType>
				<storageHandlingHigh unit="Degrees Celsius" value="30"/>
				<storageHandlingLow unit="Degrees Celsius" value="15"/>
				<storageHandlingSpecialConditionText xsi:nil="true"/>
			</storageHandling>
			<storageHandling>
				<storageHandlingType>Special Storage Condition, Specify</storageHandlingType>
				<storageHandlingHigh unit="" value=""/>
				<storageHandlingLow unit="" value=""/>
				<storageHandlingSpecialConditionText>
					Store in a dry, dark, cool place. Protect from light. Store at 25 degrees C; excursions between 15 to 30 degrees C permitted.
				</storageHandlingSpecialConditionText>
			</storageHandling>
			<storageHandling>
				<storageHandlingType>Storage Environment Temperature</storageHandlingType>
				<storageHandlingHigh unit="Degrees Celsius" value="25"/>
				<storageHandlingLow unit="Degrees Celsius" value="25"/>
				<storageHandlingSpecialConditionText xsi:nil="true"/>
			</storageHandling>
		</environmentalConditions>
		<sterilization>
			<deviceSterile>true</deviceSterile>
			<sterilizationPriorToUse>false</sterilizationPriorToUse>
			<methodTypes/>
		</sterilization>
	</device>
</gudid>