Data Services Software

DEA State License API Documentation

By DEA Lookup.com, Inc. · Updated October 19, 2026

Short answer: The DEA Lookup.com DEA State License API finds DEA registrations by state license number. Send a state and a state license or state controlled substance (CS) license number, and the API searches daily-updated primary source DEA data on your own server and returns the matching DEA registration records. It searches DEA data only; to verify the state license with the state board, use the State Medical License API.

The DEA State License API is an optional add-on to the Pro edition of the DEA API Data Engine. For an overview of all four DEA APIs, see the DEA API Documentation.

DEA State License API vs. State Medical License API

DEA State License APIState Medical License API
SearchesDEA registration data on your serverThe state licensing board's website, in real time
You sendA state and a state license or CS license numberA state license number, state, and license type
You getThe DEA registrations associated with that licenseThe license status and expiration date from the state board
Use it toFind the DEA number tied to a state licenseVerify the state license with the primary source

Using them together

  1. Validate a DEA number with the Standard API and read the state_license field, or start from a state license and find its DEA registration with this API.
  2. Verify that state license with the State Medical License API.
  3. The result is a complete prescriber check: an active DEA registration and an active state license, both confirmed against primary source data.

Endpoint

The API runs on your own server, on the port set in the administrator interface:

POST https://[your server]/stateLicense

Request parameters

#ParameterRequiredDescriptionDefault
1usernameYesYour API username.
2passwordYesYour API password.
3stateYesTwo-letter state code, for example PA.
4stateLicenseYesThe state license or CS license number to search for.
5csLicenseNoWhich license field to search: 0 = state license only, 1 = CS license only, 2 = both.0
6wildcardSearchNo0 = match the full license number, 1 = match any license number that contains the text.0
7OutputTypeNoPipeDelimited, XML, or JSON. If left out, the default set in the administrator interface is used.

Example requests

Find the DEA registration for state license PP000000 in Pennsylvania:

POST https://[your server]/stateLicense
Content-Type: application/x-www-form-urlencoded

username=YOUR_USERNAME&password=YOUR_PASSWORD&state=PA&stateLicense=PP000000&OutputType=JSON

Search both state license and CS license numbers containing "000000":

username=YOUR_USERNAME&password=YOUR_PASSWORD&state=PA&stateLicense=000000&csLicense=2&wildcardSearch=1&OutputType=JSON

Response: matches found

Each matching DEA registration is returned as one record, with the same fields as the Standard API.

JSON

{
  "response": [
    {
      "result_indicator": 1,
      "dea_number": "AS1234563",
      "bac": "A",
      "drug_schedule": "2 2N 3 3N 4 5",
      "expiration_date": "20280430",
      "full_name": "SAMPLE PHARMACY INC",
      "additional_name": "MAIN STREET PHARMACY",
      "address": "100 MAIN ST",
      "address_secondary": "SUITE 1",
      "city": "ANYTOWN",
      "state": "PA",
      "zip": "12345",
      "bac_subcode": "0",
      "payment_indicator": "P",
      "status": "Active",
      "pro_desination": "",
      "state_license": "PP000000",
      "state_license_secondary": "CS000000",
      "data_import_date": "10/18/2026"
    }
  ]
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <record>
    <result_indicator>1</result_indicator>
    <dea_number>AS1234563</dea_number>
    <bac>A</bac>
    <drug_schedule>2 2N 3 3N 4 5</drug_schedule>
    <expiration_date>20280430</expiration_date>
    <full_name>SAMPLE PHARMACY INC</full_name>
    <additional_name>MAIN STREET PHARMACY</additional_name>
    <address>100 MAIN ST</address>
    <address_secondary>SUITE 1</address_secondary>
    <city>ANYTOWN</city>
    <state>PA</state>
    <zip>12345</zip>
    <bac_subcode>0</bac_subcode>
    <payment_indicator>P</payment_indicator>
    <status>Active</status>
    <pro_desination></pro_desination>
    <state_license>PP000000</state_license>
    <state_license_secondary>CS000000</state_license_secondary>
    <data_import_date>10/18/2026</data_import_date>
  </record>
</response>

Pipe-delimited (one line per record)

1|AS1234563|A|2 2N 3 3N 4 5|20280430|SAMPLE PHARMACY INC|MAIN STREET PHARMACY|100 MAIN ST|SUITE 1|ANYTOWN|PA|12345|0|P|Active||PP000000|CS000000|10/18/2026

Example data is fictional. For a description of every field, business activity code, and subcode, see the Standard API field reference.

Response: no results

{
  "result_indicator": 0,
  "message": "No result"
}

Response: errors

Errors return a result indicator, a detail value, and a message, for example when no state is sent:

{
  "result_indicator": 2,
  "detail": "Error",
  "message": "state not entered"
}

Integration tips

How DEA Lookup.com helps

Related: DEA API Documentation, State License API Documentation, How to Verify a State Medical License in All 50 States, and DEA and NPI Cross-Referencing

Frequently asked questions

What does the DEA State License API do?

The DEA State License API searches DEA registration data by state license number or state controlled substance (CS) license number. It returns the DEA registrations associated with that license, including the DEA number, status, expiration date, drug schedules, and address.

Does the DEA State License API verify the state license with the state board?

No. The DEA State License API searches DEA registration data, which lists the state license numbers associated with each DEA registration. To verify the state license itself with the state licensing board, use the DEA Lookup.com State Medical License API.

Can I search by state controlled substance license number?

Yes. Set the csLicense parameter to 1 to search only state controlled substance (CS) license numbers, or to 2 to search both state license and CS license numbers. The default, 0, searches state license numbers only.

What if I only have part of a state license number?

Set the wildcardSearch parameter to 1. The API then matches any state license number that contains the text you send, anywhere in the number. The default, 0, matches the full license number only.

Is the DEA State License API included with every subscription?

No. The DEA State License API is an optional add-on to the Pro edition of the DEA API Data Engine. Contact sales@dealookup.com for details.

Connect DEA registrations and state licenses inside your own systems. Subscribe today or email sales@dealookup.com to schedule a demo.

DEA Lookup.com is not affiliated with the Drug Enforcement Administration or any state licensing board.