API Reference

Authentication

Pass your API key in the Authorization header on every request. A key is required for all tiers — including free. Requests without a valid key return 401.

curl "https://lotlyze.com/api/lookup?query=3016070023" \
  -H "Authorization: Bearer YOUR_API_KEY"

const API_KEY = "YOUR_API_KEY"; // from lotlyze.com/account

const res = await fetch(
  "https://lotlyze.com/api/lookup?query=3016070023",
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);
const data = await res.json();

import httpx

API_KEY = "YOUR_API_KEY"  # from lotlyze.com/account
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

data = httpx.get(
    "https://lotlyze.com/api/lookup",
    params={"query": "3016070023"},
    headers=HEADERS,
).json()

Where to find your key

1. Sign in at lotlyze.com/sign-in
2. Go to My Account
3. Copy the key from the API Key section
4. Use it in the Authorization: Bearer <key> header

Error responses

Resolve any address, BBL, or BIN to canonical identifiers.

Parameters

Example

curl "https://lotlyze.com/api/lookup?query=250+Broadway+Manhattan" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch(
  "https://lotlyze.com/api/lookup?query=250+Broadway+Manhattan",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const { bbl, bin, label } = await res.json();

Response

{
  "type": "address",
  "bbl": "1000477501",
  "bin": "1001074",
  "label": "250 Broadway, Manhattan, NY 10007",
  "source": "geosearch"
}

Fetch ACRIS deed and document records for a property.

Parameters

Example

curl "https://lotlyze.com/api/acris?bbl=1000477501" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "bbl": "1000477501",
  "records": [
    {
      "id": "2023012700123456",
      "date": "2023-01-27",
      "type": "DEED",
      "description": "DEED",
      "party1": "SELLER NAME",
      "party2": "BUYER NAME",
      "amount": 4500000,
      "formattedAmount": "$4,500,000"
    }
  ]
}

Fetch DOB permits, job filings, violations, and complaints for a building.

Parameters

Example

curl "https://lotlyze.com/api/dob?bin=1001074" \
  -H "Authorization: Bearer YOUR_API_KEY"

Full property summary: ACRIS + all DOB data in a single request. Resolves BBL to BIN automatically.

Parameters

Example

curl "https://lotlyze.com/api/summary?bbl=1000477501" \
  -H "Authorization: Bearer YOUR_API_KEY"

import httpx

API_KEY = "YOUR_API_KEY"

data = httpx.get(
    "https://lotlyze.com/api/summary",
    params={"bbl": "1000477501"},
    headers={"Authorization": f"Bearer {API_KEY}"},
).json()

print(data["acris"][0]["date"])   # most recent deed date
print(len(data["dob"]["violations"]))

Look up up to 50 BBLs in a single request. Returns ACRIS + DOB data for each. Requires a Developer API key in the Authorization header.

Parameters (POST body JSON)

Example

curl -X POST "https://lotlyze.com/api/bulk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bbls": ["3016070023", "1004770001", "4015670023"]}'