GET /v1/devices/lookup (v1)

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.

This API is going to be deprecated. Please move to the v2 Device Lookup API.

Resource Information

format	URL
`JSON`	`https://accessgudid-beta.nlm.nih.gov/api/v1/devices/lookup.json`
`XML`	`https://accessgudid-beta.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-beta.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-beta.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>