Reference

API reference

Generated from the OpenAPI 3.1 document — the machine-readable source of truth. Every mock response below is exactly what a dd_test_ key returns; the console on each endpoint sends real requests with the public test key.

Restaurants

Establishments keyed by CAMIS permit number.

Search restaurants

GET/api/v1/restaurants/search

Name or street search — the typeahead endpoint. Best matches first.

Parameters

Name	Type	Description
q *	string	Name or address fragment, 2–120 chars.
limit	integer	Max results, 1–25 (default 10).

Response — the `data` object

Field	Type	Description
camis	string	DOHMH permit number — the establishment's id.
name	string	Doing-business-as name.
address	string	Street address (borough is its own field).
borough	string	Borough.
zip	string \| null	ZIP code.
cuisine	string \| null	Cuisine description.
grade	string \| null	Posted grade: A\|B\|C\|Z\|P\|N (Z/P = pending, N = not yet graded).
score	integer \| null	Latest inspection score — LOWER is better; 0–13 is the A band.
closed	boolean	Currently marked closed by the Health Department.
riskLevel	LOW \| MODERATE \| HIGH \| SEVERE	LOW \| MODERATE \| HIGH \| SEVERE.
riskScore	integer	0–100, higher is worse.
lastInspectedAt	string \| null	Most recent inspection.
latitude	number \| null
longitude	number \| null
openViolations	integer	Items open right now (latest-cycle citations).

request · cURL

curl "https://www.dailydog.ai/api/v1/restaurants/search?q=example" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    {
      "camis": "90000001",
      "name": "THE GILDED SPOON",
      "address": "12 TEST STREET",
      "borough": "Manhattan",
      "zip": "10001",
      "cuisine": "French",
      "grade": "A",
      "score": 9,
      "closed": false,
      "riskLevel": "LOW",
      "riskScore": 4,
      "lastInspectedAt": "2026-05-01",
      "latitude": 40.75,
      "longitude": -73.99,
      "openViolations": 1
    }
  ]
}

Browse & filter restaurants

GET/api/v1/restaurants

The whole city, filterable. Grade/score/risk/closure filters are computed from each establishment's full record, so filtered pages can return fewer than `limit` rows — keep following `meta.nextCursor`.

Paginated — follow meta.nextCursor until null.

Parameters

Name	Type	Description
q	string	Name or address fragment.
borough	string	Comma list of boroughs.
zip	string	Comma list of ZIP codes.
cuisine	string	Comma list of cuisines (see /v1/meta/cuisines).
grade	string	Comma list of current grades (A,B,C,Z,P,N).
riskLevel	string	Comma list of risk levels.
minScore	integer	Current inspection score at least this (higher is worse).
maxScore	integer	Current inspection score at most this.
closed	boolean	Only establishments currently marked closed (or not).
hasOpenViolations	boolean	Only establishments with (or without) open items.
verminSince	string	Had a vermin-category citation on/after this date.
inspectedSince	string	Last inspected on/after this date.
inspectedUntil	string	Last inspected on/before this date.
sort	name \| -name \| lastInspectedAt \| -lastInspectedAt	`name` or `lastInspectedAt`; prefix `-` for descending (default `-lastInspectedAt`).
limit	integer	Page size, 1–100 (default 20).
cursor	string	Opaque page cursor from the previous response's `meta.nextCursor`.

Response — the `data` object

Field	Type	Description
camis	string	DOHMH permit number — the establishment's id.
name	string	Doing-business-as name.
address	string	Street address (borough is its own field).
borough	string	Borough.
zip	string \| null	ZIP code.
cuisine	string \| null	Cuisine description.
grade	string \| null	Posted grade: A\|B\|C\|Z\|P\|N (Z/P = pending, N = not yet graded).
score	integer \| null	Latest inspection score — LOWER is better; 0–13 is the A band.
closed	boolean	Currently marked closed by the Health Department.
riskLevel	LOW \| MODERATE \| HIGH \| SEVERE	LOW \| MODERATE \| HIGH \| SEVERE.
riskScore	integer	0–100, higher is worse.
lastInspectedAt	string \| null	Most recent inspection.
latitude	number \| null
longitude	number \| null
openViolations	integer	Items open right now (latest-cycle citations).

request · cURL

curl "https://www.dailydog.ai/api/v1/restaurants" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    {
      "camis": "90000005",
      "name": "MIDNIGHT DINER",
      "address": "700 EXAMPLE CONCOURSE",
      "borough": "Bronx",
      "zip": "10451",
      "cuisine": "American",
      "grade": "C",
      "score": 38,
      "closed": false,
      "riskLevel": "HIGH",
      "riskScore": 58,
      "lastInspectedAt": "2026-06-05",
      "latitude": 40.827,
      "longitude": -73.925,
      "openViolations": 3
    }
  ],
  "meta": {
    "nextCursor": "bzoyMA",
    "returned": 1
  }
}

Restaurants near a point

GET/api/v1/restaurants/nearby

Nearest-first within `radius` meters, each with `distanceMeters`.

Parameters

Name	Type	Description
lat *	number	NYC latitude.
lng *	number	NYC longitude.
radius	integer	Meters, 1–2000 (default 300).
limit	integer	Max results, 1–50 (default 20).
grade	string	Comma list of grades to keep.
cuisine	string	Comma list of cuisines to keep.
riskLevel	string	Comma list of risk levels to keep.
maxScore	integer	Keep scores at or below this.

Response — the `data` object

Field	Type	Description
camis	string	DOHMH permit number — the establishment's id.
name	string	Doing-business-as name.
address	string	Street address (borough is its own field).
borough	string	Borough.
zip	string \| null	ZIP code.
cuisine	string \| null	Cuisine description.
grade	string \| null	Posted grade: A\|B\|C\|Z\|P\|N (Z/P = pending, N = not yet graded).
score	integer \| null	Latest inspection score — LOWER is better; 0–13 is the A band.
closed	boolean	Currently marked closed by the Health Department.
riskLevel	LOW \| MODERATE \| HIGH \| SEVERE	LOW \| MODERATE \| HIGH \| SEVERE.
riskScore	integer	0–100, higher is worse.
lastInspectedAt	string \| null	Most recent inspection.
latitude	number \| null
longitude	number \| null
openViolations	integer	Items open right now (latest-cycle citations).
distanceMeters	integer	Distance from the query point.

request · cURL

curl "https://www.dailydog.ai/api/v1/restaurants/nearby?lat=40.75&lng=-73.99" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    {
      "camis": "90000001",
      "name": "THE GILDED SPOON",
      "address": "12 TEST STREET",
      "borough": "Manhattan",
      "zip": "10001",
      "cuisine": "French",
      "grade": "A",
      "score": 9,
      "closed": false,
      "riskLevel": "LOW",
      "riskScore": 4,
      "lastInspectedAt": "2026-05-01",
      "latitude": 40.75,
      "longitude": -73.99,
      "openViolations": 1,
      "distanceMeters": 142
    }
  ]
}

Full restaurant profile

GET/api/v1/restaurants/{camis}

Identity, posted grade, the full risk assessment (inspections AND the hearing docket), the 3-year vermin report, and the money.

Parameters

Name	Type	Description
camis * (path)	string	DOHMH permit number.

Response — the `data` object

Field	Type	Description
restaurant	RestaurantSummary
gradeDate	string \| null	When the posted grade was issued.
risk	object
↳ score	integer	0–100, higher is worse.
↳ level	LOW \| MODERATE \| HIGH \| SEVERE	LOW \| MODERATE \| HIGH \| SEVERE.
↳ factors	array<object>
↳ key	string	Stable factor key.
↳ label	string	Human label.
↳ count	integer	Matching records.
↳ detail	string	Why it matters.
vermin	VerminReport
stats	RestaurantStats

request · cURL

curl "https://www.dailydog.ai/api/v1/restaurants/90000005" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": {
    "restaurant": {
      "camis": "90000005",
      "name": "MIDNIGHT DINER",
      "address": "700 EXAMPLE CONCOURSE",
      "borough": "Bronx",
      "zip": "10451",
      "cuisine": "American",
      "grade": "C",
      "score": 38,
      "closed": false,
      "riskLevel": "HIGH",
      "riskScore": 58,
      "lastInspectedAt": "2026-06-05",
      "latitude": 40.827,
      "longitude": -73.925,
      "openViolations": 3
    },
    "gradeDate": "2026-06-05",
    "risk": {
      "score": 58,
      "level": "HIGH",
      "factors": [
        {
          "key": "vermin",
          "label": "Vermin activity cited",
          "count": 3,
          "detail": "Roach, rodent, or fly evidence — the violations most likely to escalate to closure when they recur."
        },
        {
          "key": "grade_trouble",
          "label": "Letter grade at risk",
          "count": 1,
          "detail": "A C grade keeps customers away and invites a compliance inspection."
        }
      ]
    },
    "vermin": {
      "mice": 2,
      "rats": 1,
      "roaches": 2,
      "flies": 0,
      "other": 0,
      "conducive": 1,
      "lastSightedAt": "2026-06-05"
    },
    "stats": {
      "openViolations": 3,
      "totalViolations": 6,
      "criticalViolations": 5,
      "inspectionCount": 2,
      "closureCount": 0,
      "oathSummonses": 0,
      "finesImposedCents": 0,
      "finesDueCents": 0,
      "defaultedHearings": 0
    }
  }
}

Inspection history

GET/api/v1/restaurants/{camis}/inspections

Every inspection visit, newest first. Lower scores are better; 0–13 is the A band.

Parameters

Name	Type	Description
camis * (path)	string	DOHMH permit number.

Response — the `data` object

Field	Type	Description
inspectedAt	string	Visit date.
type	string \| null	Inspection program/type.
score	integer \| null	Score issued at this visit (lower is better).
grade	string \| null	Grade issued at this visit, if any.
action	string \| null	The Health Department's action line.
closedRestaurant	boolean	This visit closed the establishment.
violations	array<Violation>

request · cURL

curl "https://www.dailydog.ai/api/v1/restaurants/90000005/inspections" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    {
      "inspectedAt": "2026-06-05",
      "type": "Cycle Inspection / Initial Inspection",
      "score": 38,
      "grade": "C",
      "action": "Violations were cited in the following area(s).",
      "closedRestaurant": false,
      "violations": [
        {
          "code": "04L",
          "description": "Evidence of mice or live mice present in facility's food and/or non-food areas.",
          "critical": true,
          "inspectedAt": "2026-06-05",
          "inspectionType": "Cycle Inspection / Initial Inspection",
          "category": "vermin"
        },
        {
          "code": "04K",
          "description": "Evidence of rats or live rats present in facility's food and/or non-food areas.",
          "critical": true,
          "inspectedAt": "2026-06-05",
          "inspectionType": "Cycle Inspection / Initial Inspection",
          "category": "vermin"
        },
        {
          "code": "04M",
          "description": "Live roaches present in facility's food and/or non-food area.",
          "critical": true,
          "inspectedAt": "2026-06-05",
          "inspectionType": "Cycle Inspection / Initial Inspection",
          "category": "vermin"
        }
      ]
    }
  ]
}

Violations

GET/api/v1/restaurants/{camis}/violations

The flat violation list, newest first.

Parameters

Name	Type	Description
camis * (path)	string	DOHMH permit number.
open	boolean	true = only citations from the most recent inspection (what a re-inspection re-checks).

Response — the `data` object

Field	Type	Description
code	string \| null	DOHMH violation code.
description	string	What was cited.
critical	boolean	Critical citations drive the score and re-inspections.
inspectedAt	string	Inspection date.
inspectionType	string \| null	Inspection program/type.
category	vermin \| food_temp \| hygiene \| facility \| admin \| other	Contract category.

request · cURL

curl "https://www.dailydog.ai/api/v1/restaurants/90000005/violations" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    {
      "code": "04L",
      "description": "Evidence of mice or live mice present in facility's food and/or non-food areas.",
      "critical": true,
      "inspectedAt": "2026-06-05",
      "inspectionType": "Cycle Inspection / Initial Inspection",
      "category": "vermin"
    },
    {
      "code": "04K",
      "description": "Evidence of rats or live rats present in facility's food and/or non-food areas.",
      "critical": true,
      "inspectedAt": "2026-06-05",
      "inspectionType": "Cycle Inspection / Initial Inspection",
      "category": "vermin"
    }
  ]
}

Batch profiles (max 50)

POST/api/v1/restaurants/batch

Refresh a saved list in one call. Unknown ids come back in `meta.notFound`.

Paginated — follow meta.nextCursor until null.

Request body

application/json

{
  "camis": [
    "90000001",
    "90000005",
    "00000000"
  ]
}

Response — the `data` object

Field	Type	Description
restaurant	RestaurantSummary
gradeDate	string \| null	When the posted grade was issued.
risk	object
↳ score	integer	0–100, higher is worse.
↳ level	LOW \| MODERATE \| HIGH \| SEVERE	LOW \| MODERATE \| HIGH \| SEVERE.
↳ factors	array<object>
↳ key	string	Stable factor key.
↳ label	string	Human label.
↳ count	integer	Matching records.
↳ detail	string	Why it matters.
vermin	VerminReport
stats	RestaurantStats

request · cURL

curl -X POST "https://www.dailydog.ai/api/v1/restaurants/batch" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985" \
  -H "Content-Type: application/json" \
  -d '{"camis":["90000001","90000005","00000000"]}'

mock response (fixture city)

{
  "data": [
    {
      "restaurant": {
        "camis": "90000005",
        "name": "MIDNIGHT DINER",
        "address": "700 EXAMPLE CONCOURSE",
        "borough": "Bronx",
        "zip": "10451",
        "cuisine": "American",
        "grade": "C",
        "score": 38,
        "closed": false,
        "riskLevel": "HIGH",
        "riskScore": 58,
        "lastInspectedAt": "2026-06-05",
        "latitude": 40.827,
        "longitude": -73.925,
        "openViolations": 3
      },
      "gradeDate": "2026-06-05",
      "risk": {
        "score": 58,
        "level": "HIGH",
        "factors": [
          {
            "key": "vermin",
            "label": "Vermin activity cited",
            "count": 3,
            "detail": "Roach, rodent, or fly evidence — the violations most likely to escalate to closure when they recur."
          },
          {
            "key": "grade_trouble",
            "label": "Letter grade at risk",
            "count": 1,
            "detail": "A C grade keeps customers away and invites a compliance inspection."
          }
        ]
      },
      "vermin": {
        "mice": 2,
        "rats": 1,
        "roaches": 2,
        "flies": 0,
        "other": 0,
        "conducive": 1,
        "lastSightedAt": "2026-06-05"
      },
      "stats": {
        "openViolations": 3,
        "totalViolations": 6,
        "criticalViolations": 5,
        "inspectionCount": 2,
        "closureCount": 0,
        "oathSummonses": 0,
        "finesImposedCents": 0,
        "finesDueCents": 0,
        "defaultedHearings": 0
      }
    }
  ],
  "meta": {
    "notFound": [
      "00000000"
    ]
  }
}

City feeds

City-wide violation and inspection streams.

City-wide violation search

GET/api/v1/violations

The headline query: "every rat citation in Brooklyn this month". Newest first.

Paginated — follow meta.nextCursor until null.

Parameters

Name	Type	Description
code	string	Comma list of violation codes (see /v1/meta/violation-codes).
category	vermin \| food_temp \| hygiene \| facility \| admin \| other	Comma list of categories.
critical	boolean	Only critical (or non-critical) citations.
borough	string	Comma list of boroughs.
zip	string	Comma list of ZIP codes.
cuisine	string	Comma list of cuisines.
q	string	Establishment-name fragment.
since	string	Cited on/after this date.
until	string	Cited on/before this date.
limit	integer	Page size, 1–100 (default 20).
cursor	string	Opaque page cursor from the previous response's `meta.nextCursor`.

Response — the `data` object

Field	Type	Description
code	string \| null	DOHMH violation code.
description	string	What was cited.
critical	boolean	Critical citations drive the score and re-inspections.
inspectedAt	string	Inspection date.
inspectionType	string \| null	Inspection program/type.
category	vermin \| food_temp \| hygiene \| facility \| admin \| other	Contract category.
camis	string	Establishment id.
restaurantName	string	Establishment name.
address	string	Street address.
borough	string	Borough.

request · cURL

curl "https://www.dailydog.ai/api/v1/violations" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    {
      "code": "04L",
      "description": "Evidence of mice or live mice present in facility's food and/or non-food areas.",
      "critical": true,
      "inspectedAt": "2026-06-05",
      "inspectionType": "Cycle Inspection / Initial Inspection",
      "category": "vermin",
      "camis": "90000005",
      "restaurantName": "MIDNIGHT DINER",
      "address": "700 EXAMPLE CONCOURSE",
      "borough": "Bronx"
    }
  ],
  "meta": {
    "nextCursor": null,
    "returned": 1
  }
}

City-wide inspection feed

GET/api/v1/inspections

"What closed this week" — one row per inspection visit, newest first.

Paginated — follow meta.nextCursor until null.

Parameters

Name	Type	Description
borough	string	Comma list of boroughs.
grade	string	Comma list of grades issued at the visit.
minScore	integer	Score at least this (higher is worse).
closedRestaurant	boolean	Only visits that closed (or didn't close) the establishment.
since	string	Inspected on/after this date.
until	string	Inspected on/before this date.
limit	integer	Page size, 1–100 (default 20).
cursor	string	Opaque page cursor from the previous response's `meta.nextCursor`.

Response — the `data` object

Field	Type	Description
camis	string	Establishment id.
name	string	Establishment name.
address	string	Street address.
borough	string	Borough.
inspectedAt	string	Visit date.
type	string \| null	Inspection program/type.
score	integer \| null	Score issued (lower is better).
grade	string \| null	Grade issued, if any.
closedRestaurant	boolean	This visit closed the establishment.

request · cURL

curl "https://www.dailydog.ai/api/v1/inspections" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    {
      "camis": "90000007",
      "name": "CROWN FRIED CLUCK",
      "address": "1490 PLACEHOLDER AVENUE",
      "borough": "Brooklyn",
      "inspectedAt": "2026-07-01",
      "type": "Cycle Inspection / Initial Inspection",
      "score": 51,
      "grade": null,
      "closedRestaurant": true
    }
  ],
  "meta": {
    "nextCursor": null,
    "returned": 1
  }
}

Meta & stats

Enumerations for filter UIs, and aggregates.

Cuisine enumeration

GET/api/v1/meta/cuisines

Most common first — feed your filter UI.

request · cURL

curl "https://www.dailydog.ai/api/v1/meta/cuisines" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    "American",
    "Chinese",
    "Pizza"
  ]
}

Borough enumeration

GET/api/v1/meta/boroughs

request · cURL

curl "https://www.dailydog.ai/api/v1/meta/boroughs" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    "Bronx",
    "Brooklyn",
    "Manhattan",
    "Queens",
    "Staten Island"
  ]
}

Violation-code enumeration

GET/api/v1/meta/violation-codes

Code → description → contract category, most cited first.

Response — the `data` object

Field	Type	Description
code	string	DOHMH violation code.
description	string	What the code means.
category	vermin \| food_temp \| hygiene \| facility \| admin \| other	Contract category.

request · cURL

curl "https://www.dailydog.ai/api/v1/meta/violation-codes" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    {
      "code": "02B",
      "description": "Hot food item not held at or above 140°F.",
      "category": "food_temp"
    },
    {
      "code": "02G",
      "description": "Cold food item held above 41°F.",
      "category": "food_temp"
    },
    {
      "code": "04H",
      "description": "Raw food not properly washed prior to serving.",
      "category": "hygiene"
    }
  ]
}

City-wide restaurant aggregates

GET/api/v1/stats/restaurants

`byGrade` counts distinct establishments graded that letter on an inspection in the last 12 months; `byBorough` counts distinct establishments on record. Cached 6 hours.

Parameters

Name	Type	Description
borough	string	Narrow to one borough.
cuisine	string	Narrow to one cuisine.

Response — the `data` object

Field	Type	Description
establishments	integer	Distinct establishments on record.
byGrade	object	Distinct establishments graded that letter in the last 12 months.
byBorough	object	Distinct establishments per borough.
violationsLast30Days	integer	Citations recorded in the last 30 days.

request · cURL

curl "https://www.dailydog.ai/api/v1/stats/restaurants" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": {
    "establishments": 8,
    "byGrade": {
      "A": 2,
      "B": 2,
      "C": 2,
      "Z": 1,
      "P": 1
    },
    "byBorough": {
      "Manhattan": 2,
      "Brooklyn": 2,
      "Queens": 2,
      "Bronx": 1,
      "Staten Island": 1
    },
    "violationsLast30Days": 6
  }
}

Properties

Buildings keyed by BBL (borough-block-lot).

Search addresses

GET/api/v1/properties/search

Free-text address → tax lots (BBL) with the public page slug.

Parameters

Name	Type	Description
q *	string	Address fragment, 3–120 chars.
limit	integer	Max results, 1–25 (default 10).

Response — the `data` object

Field	Type	Description
bbl	string	10-digit borough-block-lot.
address	string	Street line.
borough	string	Borough.
slug	string	Public page: dailydog.ai/property/<slug>.

request · cURL

curl "https://www.dailydog.ai/api/v1/properties/search?q=example" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    {
      "bbl": "1011850028",
      "address": "302 West 76 Street",
      "borough": "Manhattan",
      "slug": "302-west-76-street-new-york"
    }
  ]
}

Property profile

GET/api/v1/properties/{bbl}

Risk score, open counts, penalty dollars, defaults, per-agency rollup.

Parameters

Name	Type	Description
bbl * (path)	string	10-digit borough-block-lot.

Response — the `data` object

Field	Type	Description
bbl	string	10-digit borough-block-lot.
address	string	Address on record.
borough	string	Borough.
riskLevel	LOW \| MODERATE \| HIGH \| SEVERE	LOW \| MODERATE \| HIGH \| SEVERE.
riskScore	integer	0–100, higher is worse.
openViolations	integer	Violations open right now.
totalRecords	integer	Records across every city system swept.
finesImposedCents	integer	Penalties imposed. Integer cents.
finesDueCents	integer	Penalties currently due — judgment exposure. Integer cents.
defaultedHearings	integer	Missed hearings that became default judgments.
agencies	array<object>
↳ agency	string	Enforcement system.
↳ openCount	integer	Open records there.

request · cURL

curl "https://www.dailydog.ai/api/v1/properties/3900020002" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": {
    "bbl": "3900020002",
    "address": "250 FIXTURE AVENUE",
    "borough": "Brooklyn",
    "riskLevel": "HIGH",
    "riskScore": 71,
    "openViolations": 6,
    "totalRecords": 87,
    "finesImposedCents": 8125000,
    "finesDueCents": 6650000,
    "defaultedHearings": 3,
    "agencies": [
      {
        "agency": "ECB",
        "openCount": 4
      },
      {
        "agency": "DOB",
        "openCount": 2
      }
    ]
  }
}

Itemized violations at a lot

GET/api/v1/properties/{bbl}/violations

The monitoring contract: poll with `since=` set to your last check to see only what's new.

Paginated — follow meta.nextCursor until null.

Parameters

Name	Type	Description
bbl * (path)	string	10-digit borough-block-lot.
agency	string	Comma list of agencies (ECB, DOB, DOB_NOW…).
status	open \| closed	`open` or `closed`.
since	string	Issued on/after this date.
until	string	Issued on/before this date.
sort	date \| -date \| penalty \| -penalty	`date` or `penalty`; prefix `-` for descending (default `-date`).
limit	integer	Page size, 1–100 (default 20).
cursor	string	Opaque page cursor from the previous response's `meta.nextCursor`.

Response — the `data` object

Field	Type	Description
identifier	string	Violation/summons number — matches the city's paperwork.
agency	string	Enforcement system (ECB, DOB…).
recordType	string	Record class.
status	string	Current status line.
description	string	What was cited.
isOpen	boolean	Still demands action.
issuedAt	string \| null	Issue date.
statusAt	string \| null	Last status/hearing date.
penaltyImposedCents	integer	Penalty imposed. Integer cents.
penaltyDueCents	integer	Balance currently due. Integer cents.

request · cURL

curl "https://www.dailydog.ai/api/v1/properties/3900020002/violations" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    {
      "identifier": "039900001R",
      "agency": "ECB",
      "recordType": "OATH summons (DOB)",
      "status": "DEFAULTED — $32,500 due",
      "description": "Work without a permit: interior demolition observed at cellar level.",
      "isOpen": true,
      "issuedAt": "2026-03-02",
      "statusAt": "2026-05-10",
      "penaltyImposedCents": 3250000,
      "penaltyDueCents": 3250000
    }
  ],
  "meta": {
    "nextCursor": null,
    "returned": 1
  }
}

Permit & job filings at a lot

GET/api/v1/properties/{bbl}/permits

What's open at the BBL before you file anew — permit history included.

Paginated — follow meta.nextCursor until null.

Parameters

Name	Type	Description
bbl * (path)	string	10-digit borough-block-lot.
status	open \| closed	`open` or `closed`.
since	string	Issued on/after this date.
until	string	Issued on/before this date.
sort	date \| -date	`date` or `-date` (default `-date`).
limit	integer	Page size, 1–100 (default 20).
cursor	string	Opaque page cursor from the previous response's `meta.nextCursor`.

Response — the `data` object

Field	Type	Description
identifier	string	Job/permit number.
agency	string	DOB \| DOB_NOW.
recordType	string	Filing class.
status	string	Current status line.
description	string	Scope of work.
isOpen	boolean	Still open (not signed off/closed).
issuedAt	string \| null	Issue/filing date.
expiresAt	string \| null	Permit expiration.
statusAt	string \| null	Last status date.

request · cURL

curl "https://www.dailydog.ai/api/v1/properties/3900020002/permits" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    {
      "identifier": "390004567",
      "agency": "DOB",
      "recordType": "Alteration job filing",
      "status": "PERMIT ISSUED",
      "description": "Facade repair, front elevation",
      "isOpen": true,
      "issuedAt": "2025-11-03",
      "expiresAt": "2026-11-03",
      "statusAt": "2025-11-03"
    }
  ],
  "meta": {
    "nextCursor": null,
    "returned": 1
  }
}

The compliance calendar

GET/api/v1/properties/{bbl}/deadlines

DailyDog-derived, not raw city data: every recurring obligation the building owes — facade cycles (FISP/LL11), benchmarking (LL84), emissions (LL97), elevator CAT1, boiler tests, HPD registration and more — with due dates, statuses, penalties, and what to do about each.

Parameters

Name	Type	Description
bbl * (path)	string	10-digit borough-block-lot.
status	string	Comma list of ok, due_soon, overdue, action_needed, unverifiable.
dueBefore	string	Only obligations due on/before this date.

Response — the `data` object

Field	Type	Description
kind	string	Stable obligation key (facade_filing, benchmarking, elevator_cat1…).
label	string	Human label.
status	ok \| due_soon \| overdue \| action_needed \| unverifiable	Obligation status.
dueDate	string \| null	Next date something is owed.
lastEvidenceAt	string \| null	Most recent satisfying filing the city shows.
basis	string	Plain-English rule + citation.
penalty	string	What missing it costs.
verifiable	boolean	False when no public record can confirm compliance — treat as a reminder.
whatToDo	string	The playbook: what to actually do, and what to have ready.
guideUrl	string \| null	Step-by-step guide on dailydog.ai.

request · cURL

curl "https://www.dailydog.ai/api/v1/properties/3900020002/deadlines" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    {
      "kind": "facade_filing",
      "label": "Facade inspection report (FISP / LL11)",
      "status": "overdue",
      "dueDate": "2026-02-21",
      "lastEvidenceAt": null,
      "basis": "DOB shows no facade report filed for the current 5-year cycle window.",
      "penalty": "$1,000/month failure-to-file plus an ECB violation.",
      "verifiable": true,
      "whatToDo": "Retain a QEWI to inspect and file the cycle report in DOB NOW immediately."
    },
    {
      "kind": "elevator_cat1",
      "label": "Elevator CAT1 annual test",
      "status": "due_soon",
      "dueDate": "2026-09-30",
      "lastEvidenceAt": "2025-09-12",
      "basis": "Every registered elevator device needs an annual CAT1 test filed with DOB.",
      "penalty": "$3,000 per device per year unfiled, plus $250/month late surcharges.",
      "verifiable": true,
      "whatToDo": "Schedule the CAT1 test with your elevator agency before the window closes."
    }
  ]
}

Portfolio screening (max 25)

POST/api/v1/properties/batch

Up to 25 BBLs → the full profile per lot. Profiles are cached server-side for 6 hours, so repeated sweeps are fast. Unknown BBLs come back in `meta.notFound`.

Paginated — follow meta.nextCursor until null.

Request body

application/json

{
  "bbls": [
    "3900020002",
    "1900010001"
  ]
}

Response — the `data` object

Field	Type	Description
bbl	string	10-digit borough-block-lot.
address	string	Address on record.
borough	string	Borough.
riskLevel	LOW \| MODERATE \| HIGH \| SEVERE	LOW \| MODERATE \| HIGH \| SEVERE.
riskScore	integer	0–100, higher is worse.
openViolations	integer	Violations open right now.
totalRecords	integer	Records across every city system swept.
finesImposedCents	integer	Penalties imposed. Integer cents.
finesDueCents	integer	Penalties currently due — judgment exposure. Integer cents.
defaultedHearings	integer	Missed hearings that became default judgments.
agencies	array<object>
↳ agency	string	Enforcement system.
↳ openCount	integer	Open records there.

request · cURL

curl -X POST "https://www.dailydog.ai/api/v1/properties/batch" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985" \
  -H "Content-Type: application/json" \
  -d '{"bbls":["3900020002","1900010001"]}'

mock response (fixture city)

{
  "data": [
    {
      "bbl": "3900020002",
      "address": "250 FIXTURE AVENUE",
      "borough": "Brooklyn",
      "riskLevel": "HIGH",
      "riskScore": 71,
      "openViolations": 6,
      "totalRecords": 87,
      "finesImposedCents": 8125000,
      "finesDueCents": 6650000,
      "defaultedHearings": 3,
      "agencies": [
        {
          "agency": "ECB",
          "openCount": 4
        },
        {
          "agency": "DOB",
          "openCount": 2
        }
      ]
    }
  ],
  "meta": {
    "notFound": []
  }
}

Contractors

Companies as the city dockets them, keyed by slug.

Browse companies

GET/api/v1/contractors

The enforcement docket, company by company. Sorting by `-finesDueCents` narrows to companies with money on the books (the records can't rank an empty balance).

Paginated — follow meta.nextCursor until null.

Parameters

Name	Type	Description
q	string	Company-name fragment.
riskLevel	string	Comma list of risk levels (balance-weighted at browse level).
minFinesDueCents	integer	Only companies owing at least this (integer cents).
minTickets	integer	Only companies with at least this many summonses.
sort	string	`tickets`, `finesDueCents`, or `name`; prefix `-` for descending (default `-tickets`).
limit	integer	Page size, 1–100 (default 20).
cursor	string	Opaque page cursor from the previous response's `meta.nextCursor`.

Response — the `data` object

Field	Type	Description
slug	string	Canonical company slug — the id for the profile endpoints.
name	string	Company name as the city dockets it.
ticketCount	integer	Summonses on the docket.
finesDueCents	integer	Outstanding balance. Integer cents.
riskLevel	LOW \| MODERATE \| HIGH \| SEVERE	Balance-weighted at browse/search level; the profile carries the full assessment.

request · cURL

curl "https://www.dailydog.ai/api/v1/contractors" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    {
      "slug": "test-titan-construction",
      "name": "Test Titan Construction Corp",
      "ticketCount": 42,
      "finesDueCents": 24800000,
      "riskLevel": "SEVERE"
    }
  ],
  "meta": {
    "nextCursor": null,
    "returned": 1
  }
}

Search companies

GET/api/v1/contractors/search

Name search, biggest outstanding balances first.

Parameters

Name	Type	Description
q *	string	Company-name fragment, 3–120 chars.
limit	integer	Max results, 1–25 (default 10).

Response — the `data` object

Field	Type	Description
slug	string	Canonical company slug — the id for the profile endpoints.
name	string	Company name as the city dockets it.
ticketCount	integer	Summonses on the docket.
finesDueCents	integer	Outstanding balance. Integer cents.
riskLevel	LOW \| MODERATE \| HIGH \| SEVERE	Balance-weighted at browse/search level; the profile carries the full assessment.

request · cURL

curl "https://www.dailydog.ai/api/v1/contractors/search?q=example" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    {
      "slug": "test-titan-construction",
      "name": "Test Titan Construction Corp",
      "ticketCount": 42,
      "finesDueCents": 24800000,
      "riskLevel": "SEVERE"
    }
  ]
}

Company docket profile

GET/api/v1/contractors/{slug}

Totals across every docket spelling of the company, plus the reopen-window savings envelope (the floor a granted new hearing erases; the ceiling if charges dismiss).

Parameters

Name	Type	Description
slug * (path)	string	Canonical company slug from search/browse.

Response — the `data` object

Field	Type	Description
slug	string	Canonical company slug.
name	string	Primary docket spelling.
riskLevel	LOW \| MODERATE \| HIGH \| SEVERE	Full reputation assessment.
tickets	integer	Summonses across every docket spelling.
openTickets	integer	Tickets still demanding action (money due or hearing ahead).
finesImposedCents	integer	Penalties imposed. Integer cents.
finesDueCents	integer	Outstanding balance. Integer cents.
defaultedHearings	integer	Unpaid default judgments.
reopenableSavingsMinCents	integer	Floor: default inflation a granted new hearing erases (live 75-day windows only). Integer cents.
reopenableSavingsMaxCents	integer	Ceiling: everything at stake in live windows if charges dismiss. Integer cents.

request · cURL

curl "https://www.dailydog.ai/api/v1/contractors/test-titan-construction" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": {
    "slug": "test-titan-construction",
    "name": "Test Titan Construction Corp",
    "riskLevel": "SEVERE",
    "tickets": 42,
    "openTickets": 17,
    "finesImposedCents": 31250000,
    "finesDueCents": 24800000,
    "defaultedHearings": 11,
    "reopenableSavingsMinCents": 4350000,
    "reopenableSavingsMaxCents": 7100000
  }
}

The itemized docket

GET/api/v1/contractors/{slug}/tickets

Every summons, newest first. `reopenableOnly=true` is the savings play: defaults whose 75-day new-hearing window is still open, each with its deadline. `hearingAfter=` surfaces upcoming hearings for self-monitoring.

Paginated — follow meta.nextCursor until null.

Parameters

Name	Type	Description
slug * (path)	string	Canonical company slug.
status	string	Comma list of open, defaulted, closed.
hearingAfter	string	Only tickets with a hearing on/after this date.
reopenableOnly	boolean	Only defaults with a live reopen window.
since	string	Issued on/after this date.
until	string	Issued on/before this date.
limit	integer	Page size, 1–100 (default 20).
cursor	string	Opaque page cursor from the previous response's `meta.nextCursor`.

Response — the `data` object

Field	Type	Description
ticket	string	10-character summons number — matches the city's paperwork.
charge	string	Lead charge description.
issued	string \| null	Violation date.
hearingDate	string \| null	Hearing date (past or scheduled).
hearingResult	string	The city's hearing result/status line.
status	open \| defaulted \| closed	open \| defaulted \| closed.
dueCents	integer	Balance due on this ticket. Integer cents.
imposedCents	integer	Penalty imposed. Integer cents.
soughtCents	integer	Scheduled amount sought — what losing at a normal hearing costs. Integer cents.
defaulted	boolean	A missed hearing turned this into a default judgment.
reopenableUntil	string \| null	Last day a new-hearing request is auto-granted; null when no live window.

request · cURL

curl "https://www.dailydog.ai/api/v1/contractors/test-titan-construction/tickets" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": [
    {
      "ticket": "039912345Z",
      "charge": "WORK WITHOUT A PERMIT",
      "issued": "2026-06-10",
      "hearingDate": "2026-07-08",
      "hearingResult": "DEFAULTED",
      "status": "defaulted",
      "dueCents": 2500000,
      "imposedCents": 2500000,
      "soughtCents": 625000,
      "defaulted": true,
      "reopenableUntil": "2026-09-21"
    }
  ],
  "meta": {
    "nextCursor": null,
    "returned": 1
  }
}

Bid-list screening (max 25)

POST/api/v1/contractors/batch

Up to 25 slugs → docket profiles. Unknown slugs come back in `meta.notFound`.

Paginated — follow meta.nextCursor until null.

Request body

application/json

{
  "slugs": [
    "test-titan-construction",
    "test-borough-builders"
  ]
}

Response — the `data` object

Field	Type	Description
slug	string	Canonical company slug.
name	string	Primary docket spelling.
riskLevel	LOW \| MODERATE \| HIGH \| SEVERE	Full reputation assessment.
tickets	integer	Summonses across every docket spelling.
openTickets	integer	Tickets still demanding action (money due or hearing ahead).
finesImposedCents	integer	Penalties imposed. Integer cents.
finesDueCents	integer	Outstanding balance. Integer cents.
defaultedHearings	integer	Unpaid default judgments.
reopenableSavingsMinCents	integer	Floor: default inflation a granted new hearing erases (live 75-day windows only). Integer cents.
reopenableSavingsMaxCents	integer	Ceiling: everything at stake in live windows if charges dismiss. Integer cents.

request · cURL

curl -X POST "https://www.dailydog.ai/api/v1/contractors/batch" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985" \
  -H "Content-Type: application/json" \
  -d '{"slugs":["test-titan-construction","test-borough-builders"]}'

mock response (fixture city)

{
  "data": [
    {
      "slug": "test-titan-construction",
      "name": "Test Titan Construction Corp",
      "riskLevel": "SEVERE",
      "tickets": 42,
      "openTickets": 17,
      "finesImposedCents": 31250000,
      "finesDueCents": 24800000,
      "defaultedHearings": 11,
      "reopenableSavingsMinCents": 4350000,
      "reopenableSavingsMaxCents": 7100000
    }
  ],
  "meta": {
    "notFound": []
  }
}

Platform

Key introspection, health, and this document.

Key introspection & usage

GET/api/v1/me

Response — the `data` object

Field	Type	Description
name	string	Key name.
tier	string	standard \| unlimited.
mode	live \| test	live \| test — test keys answer from the fixture city.
createdAt	string	ISO timestamp.
usage	object
↳ today	integer	Requests since midnight UTC.
↳ last30Days	integer	Requests over 30 days.
↳ dailyLimit	integer \| null	Your commissioned daily limit; null = unlimited.

request · cURL

curl "https://www.dailydog.ai/api/v1/me" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "data": {
    "name": "My food app",
    "tier": "standard",
    "mode": "live",
    "createdAt": "2026-07-21T14:02:11.000Z",
    "usage": {
      "today": 412,
      "last30Days": 8907,
      "dailyLimit": 50000
    }
  }
}

Liveness

GET/api/v1/health

request · cURL

curl "https://www.dailydog.ai/api/v1/health" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{
  "status": "ok",
  "version": "1.1"
}

This document

GET/api/v1/openapi.json

request · cURL

curl "https://www.dailydog.ai/api/v1/openapi.json" \
  -H "Authorization: Bearer dd_test_d23d83e5ee04c87b1fee30680033c31aa0ef7985"

mock response (fixture city)

{}