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

# Retrieve a License

> Look up a single liquor license by state and license number.

Retrieve a single liquor license by its state and exact license number.

```bash theme={null}
GET /v2/license/:state/:license
```

## Path parameters

<ParamField path="state" type="string" required>
  The two-digit USPS state code (for example, `ny`). Must be a [supported state](/supported-states) your key is scoped to. Unsupported states return a `404`.
</ParamField>

<ParamField path="license" type="string" required>
  The liquor license or permit number issued by the government authority. Must be an **exact** match and must include any leading zeros.
</ParamField>

## Returns

Returns a [license object](/liquor-licenses/license-object) if the call succeeds and a matching license is found. Returns `null` if the call succeeds but no license is found.

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.licensesearcher.com/v2/license/ny/1026288" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch(
    "https://api.licensesearcher.com/v2/license/ny/1026288",
    { headers: { Authorization: "Bearer YOUR_API_KEY" } }
  );
  if (!res.ok) throw new Error(`Request failed: ${res.status}`);
  const data = await res.json();
  console.log(data);
  ```

  ```python Python theme={null}
  import requests

  res = requests.get(
      "https://api.licensesearcher.com/v2/license/ny/1026288",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )
  res.raise_for_status()
  print(res.json())
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": {
      "license": "1026288",
      "object": "license",
      "address": {
        "city": "NEW YORK",
        "county": "NEW YORK",
        "line_1": "787 7TH AVENUE",
        "line_2": "THE EQUITABLE TOWER CENTER",
        "state": "NY",
        "zip": "10019"
      },
      "business": "LE BERNARDIN",
      "dates": {
        "ny": {
          "effective": "2023-01-01",
          "expires": "2024-12-31",
          "issued_latest": null,
          "issued_original": "2022-11-29"
        }
      },
      "details": {
        "class": null,
        "description": null,
        "type": "OP"
      },
      "owner": "LE BERNARDIN INC",
      "phone": null,
      "state": "ny",
      "status": "active",
      "updated_at": "2023-10-31 21:41:50.555399"
    }
  }
  ```
</ResponseExample>