March 1, 2023
AccessGUDID API changes to include UMLS API authentication using API Key
AccessGUDID API calls for SNOMED information have been updated to accept a UMLS API Key for authentication.
This change reduces the burden on users, with the new option requiring a single API call to retrieve data instead of multiple API calls.
The two AccessGUDID APIs affected by this are the Device SNOMED API and the Implantable List API .
The change for AccessGUDID would be switching the ST parameter to a new apiKey parameter.
Here are a few examples of these APIs with either single-use ticket or API Key :
Device SNOMED:
-
Single-use ticket:
https://accessgudid.nlm.nih.gov/api/v2/devices/snomed?ticket={ST}&di=08717648200274
-
API Key:
https://accessgudid.nlm.nih.gov/api/v2/devices/snomed?apiKey={API_KEY}&di=08717648200274
Implantable List:
-
Single-use ticket:
https://accessgudid.nlm.nih.gov/api/v2/devices/implantable/list.json?ticket={ST}&page=30&per_page=2
-
API Key:
https://accessgudid.nlm.nih.gov/api/v2/devices/implantable/list.json?apiKey={API_KEY}&page=30&per_page=2
Implantable List Download:
-
Single-use ticket:
https://accessgudid.nlm.nih.gov/api/v2/devices/implantable/download?ticket={ST}
-
API Key:
https://accessgudid.nlm.nih.gov/api/v2/devices/implantable/download?apiKey={API_KEY}