> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexusfeed.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# New York SLA License Lookup API

> Verify New York liquor licenses via the New York State Liquor Authority Open Data SODA API.

The New York State Liquor Authority (SLA) publishes all active liquor license records through the state's Open Data portal, exposed as a SODA (Socrata Open Data) API at `data.ny.gov`. NexusFeed mirrors the SODA endpoint directly, which is faster and more reliable than scraping the SLA's public-facing license lookup site. Data is updated daily by the state.

## State overview

| Field                 | Value                                  |
| --------------------- | -------------------------------------- |
| **State code**        | NY                                     |
| **Agency**            | New York State Liquor Authority        |
| **Source**            | NY Open Data SODA API (`data.ny.gov`)  |
| **Authentication**    | None required                          |
| **CAPTCHA**           | None                                   |
| **Search supported**  | Yes (`dba_name`, `owner_name`, `city`) |
| **Lookup supported**  | Yes                                    |
| **Extraction method** | `api_mirror`                           |
| **Cache TTL**         | 24 hours                               |

<Warning>
  **Active licenses only.** The NY Open Data feed only exposes licenses that are currently active. Expired, suspended, and revoked licenses are not included. If you need to verify that a license has been revoked, this state will return `404 NOT_FOUND` even though the record exists in the SLA's internal systems.
</Warning>

## Search example

```bash theme={null}
curl "https://api.nexusfeed.dev/v1/abc/search?state=NY&dba_name=SHAKE%20SHACK" \
  -H "X-API-Key: YOUR_KEY"
```

The `address` parameter is interpreted as a **city filter** on the NY SODA API, not a street address.

## Lookup example

```bash theme={null}
curl "https://api.nexusfeed.dev/v1/abc/license/1234567?state=NY" \
  -H "X-API-Key: YOUR_KEY"
```

## Example response

```json theme={null}
{
  "state": "NY",
  "query": {"dba_name": "SHAKE SHACK"},
  "total_results": 12,
  "results": [
    {
      "license_number": "1234567",
      "license_type_code": "OP",
      "dba_name": "SHAKE SHACK MADISON SQUARE",
      "owner_name": "SSE RESTAURANT HOLDINGS LLC",
      "status": "ACTIVE",
      "expiration_date": "2026-11-30",
      "address": "E 23RD ST, NEW YORK, NY 10010",
      "county": "NEW YORK"
    }
  ],
  "_verifiability": {
    "source_timestamp": "2026-04-10T14:22:11Z",
    "extraction_confidence": 1.0,
    "raw_data_evidence_url": "https://data.ny.gov/resource/hrvs-fxs2.json?dba_name=SHAKE%20SHACK",
    "extraction_method": "api_mirror",
    "data_freshness_ttl_seconds": 86400
  }
}
```

## New York license class codes (most common)

| Code | Class                      |
| ---- | -------------------------- |
| `OP` | On-Premises Liquor License |
| `RW` | Restaurant Wine License    |
| `RB` | Restaurant Beer License    |
| `A`  | All-Alcohol Tavern License |
| `W`  | Off-Premises Wine License  |
| `L`  | Liquor Store License       |

## Use cases

* Verifying a New York City, Long Island, or upstate bar or restaurant has an active SLA license before entering a distributor agreement.
* Pulling all currently-active licenses for a brand name (e.g. chain restaurants) for compliance monitoring.
* Building a New York liquor license watchlist filtered by city, county, or license class.
* Cross-referencing holder names during due diligence.