Skip to main content
POST
/
api
/
openfda
/
device
/
udi
/
search
/openfda/device/udi/search
curl --request POST \
  --url https://api.anysite.io/api/openfda/device/udi/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "keyword": "catheter",
  "brand_name": "ORTHOFIX",
  "company_name": "ORTHOFIX SRL",
  "device_description": "ecg leadwires",
  "catalog_number": "99-60003697",
  "version_or_model_number": "1",
  "product_code": "HSB",
  "gmdn_term": "Bone nail trial",
  "is_rx": true,
  "is_otc": true
}
'
[
  {
    "public_device_record_key": "<string>",
    "@type": "OpenfdaDeviceUdi",
    "brand_name": "<string>",
    "company_name": "<string>",
    "device_description": "<string>",
    "version_or_model_number": "<string>",
    "catalog_number": "<string>",
    "labeler_duns_number": "<string>",
    "record_status": "<string>",
    "commercial_distribution_status": "<string>",
    "commercial_distribution_end_at": 123,
    "mri_safety": "<string>",
    "device_count_in_base_package": "<string>",
    "public_version_number": "<string>",
    "public_version_status": "<string>",
    "publish_at": 123,
    "public_version_at": 123,
    "is_rx": true,
    "is_otc": true,
    "is_kit": true,
    "is_combination_product": true,
    "is_single_use": true,
    "is_hct_p": true,
    "is_pm_exempt": true,
    "is_direct_marking_exempt": true,
    "has_expiration_date": true,
    "has_lot_or_batch_number": true,
    "has_serial_number": true,
    "has_manufacturing_date": true,
    "has_donation_id_number": true,
    "is_labeled_as_nrl": true,
    "is_labeled_as_no_nrl": true,
    "identifiers": [],
    "product_codes": [],
    "gmdn_terms": [],
    "device_sizes": [],
    "storage": [],
    "premarket_submissions": [],
    "customer_contacts": [],
    "sterilization": {
      "@type": "OpenfdaUdiSterilization",
      "is_sterile": true,
      "is_sterilization_prior_use": true
    },
    "web_url": ""
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required

Number of device records to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
keyword
string | null

Free-text query across all UDI fields

Example:

"catheter"

brand_name
string | null

Device brand name

Example:

"ORTHOFIX"

company_name
string | null

Labeler company name

Example:

"ORTHOFIX SRL"

device_description
string | null

Text in the device description

Example:

"ecg leadwires"

catalog_number
string | null

Catalog number

Example:

"99-60003697"

version_or_model_number
string | null

Version or model number

Example:

"1"

product_code
string | null

FDA product code

Example:

"HSB"

gmdn_term
string | null

GMDN term name

Example:

"Bone nail trial"

is_rx
boolean | null

Only prescription (or non-prescription) devices

is_otc
boolean | null

Only over-the-counter (or non-OTC) devices

mri_safety
enum<string> | null

MRI safety labeling

Available options:
MR Safe,
MR Unsafe,
MR Conditional,
Labeling does not contain MRI Safety Information
record_status
enum<string> | null

GUDID record status

Available options:
Published,
Deactivated,
Archived
commercial_distribution_status
enum<string> | null

Commercial distribution status

Available options:
In Commercial Distribution,
Not in Commercial Distribution

Response

Successful Response

public_device_record_key
string
required
@type
string
default:OpenfdaDeviceUdi
brand_name
string | null
company_name
string | null
device_description
string | null
version_or_model_number
string | null
catalog_number
string | null
labeler_duns_number
string | null
record_status
string | null
commercial_distribution_status
string | null
commercial_distribution_end_at
integer | null
mri_safety
string | null
device_count_in_base_package
string | null
public_version_number
string | null
public_version_status
string | null
publish_at
integer | null
public_version_at
integer | null
is_rx
boolean | null
is_otc
boolean | null
is_kit
boolean | null
is_combination_product
boolean | null
is_single_use
boolean | null
is_hct_p
boolean | null
is_pm_exempt
boolean | null
is_direct_marking_exempt
boolean | null
has_expiration_date
boolean | null
has_lot_or_batch_number
boolean | null
has_serial_number
boolean | null
has_manufacturing_date
boolean | null
has_donation_id_number
boolean | null
is_labeled_as_nrl
boolean | null
is_labeled_as_no_nrl
boolean | null
identifiers
object[]
product_codes
object[]
gmdn_terms
object[]
device_sizes
object[]
storage
object[]
premarket_submissions
object[]
customer_contacts
object[]
sterilization
object | null
web_url
string
default:""