Skip to content
All data sources

NYC Property Timeline API and MCP server

No authnyc-property-timeline

One exact BBL timeline across ACRIS, DOB permits, HPD violations, and executed evictions.

NYC Property Timeline is published by NYC Open Data property-history datasets and covers New York City properties matched by exact ten-digit BBL.

It refreshes on a schedule the publisher sets.

Last verified . That is when these facts were last rebuilt from the ParcelOps source registry, not when NYC Open Data property-history datasets last refreshed the data itself.

API access

Your AI client reaches NYC Property Timeline through one ParcelOps MCP endpoint, so there is no separate key to hold for it and no per-source client to write. Reaching it takes no credentials of your own.

Where it came from

Freshness and coverage

FreshnessScheduled · Each of the five fixed NYC datasets retains its own publication schedule.
Places coveredNew York City properties matched by exact ten-digit BBL
Time coveredNot declared
CredentialsNo credentials required

What this source cannot tell you

  • Anything outside New York City properties matched by exact ten-digit BBL. A request past that edge comes back empty rather than approximated.
  • Which years it spans, because the covered period is not declared.
  • Anything NYC Open Data property-history datasets does not publish. ParcelOps returns this source as it stands and never fills a blank field from a different one.
  • The timeline can be incomplete or delayed and is not a title or lien search, legal opinion, appraisal, tenant screen, inspection, or proof of current code status.
  • ParcelOps excludes party names, permittee and owner contacts, marshal names, court/docket identifiers, and apartment numbers.

Methods (2)

A method is one call your agent can make against this source.

  • getPropertyTimeline

    read

    Join five fixed public datasets for one exact ten-digit Borough-Block-Lot identifier.

    What you must providebbl
    FreshnessScheduled (source-level)
    Input schema
    {
      "type": "object",
      "properties": {
        "bbl": {
          "type": "string",
          "pattern": "^[1-5]\\d{9}$"
        },
        "limitPerSource": {
          "type": "integer",
          "minimum": 1,
          "maximum": 100
        },
        "includeViolationDescriptions": {
          "type": "boolean"
        }
      },
      "required": [
        "bbl"
      ],
      "additionalProperties": false
    }
  • getServiceInfo

    read

    Return fixed datasets, privacy exclusions, result limits, and legal-use notes.

    FreshnessScheduled (source-level)
    Input schema
    {
      "type": "object",
      "properties": {},
      "required": [],
      "additionalProperties": false
    }

Where this source is used