DEA State License API Documentation
By DEA Lookup.com, Inc. · Updated October 19, 2026
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 API | State Medical License API | |
|---|---|---|
| Searches | DEA registration data on your server | The state licensing board's website, in real time |
| You send | A state and a state license or CS license number | A state license number, state, and license type |
| You get | The DEA registrations associated with that license | The license status and expiration date from the state board |
| Use it to | Find the DEA number tied to a state license | Verify the state license with the primary source |
Using them together
- Validate a DEA number with the Standard API and read the
state_licensefield, or start from a state license and find its DEA registration with this API. - Verify that state license with the State Medical License API.
- 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
| # | Parameter | Required | Description | Default |
|---|---|---|---|---|
| 1 | username | Yes | Your API username. | |
| 2 | password | Yes | Your API password. | |
| 3 | state | Yes | Two-letter state code, for example PA. | |
| 4 | stateLicense | Yes | The state license or CS license number to search for. | |
| 5 | csLicense | No | Which license field to search: 0 = state license only, 1 = CS license only, 2 = both. | 0 |
| 6 | wildcardSearch | No | 0 = match the full license number, 1 = match any license number that contains the text. | 0 |
| 7 | OutputType | No | PipeDelimited, 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
- Start with a full-number search and use
wildcardSearch=1only when the license number is incomplete or formatted differently. - Use
csLicense=2when you are not sure whether a number is a state license or a state controlled substance license. - Check the DEA record: confirm
statusisActiveandexpiration_dateis in the future. - Verify the license itself with the State Medical License API.
How DEA Lookup.com helps
- DEA API Data Engine: daily-updated primary source DEA data inside your own applications, including finding DEA registrations by state license.
- State Medical License API: real-time primary source state license verification in all 50 states.
- DEA to State License Cross Reference: cross-reference DEA numbers to state license numbers without writing code.
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.
DEA Lookup.com is not affiliated with the Drug Enforcement Administration or any state licensing board.
