# Locus NYC Recording History

> Locus NYC Recording History is a paid API for AI agents from api.locus.report, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Retrieves the official NYC property recording history (deed transfers, mortgages, liens, etc.) for a given BBL or address from public land records.

## Facts

- Endpoint: POST https://api.locus.report/api/locus-nyc-recording-history
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/locus-nyc-recording-history-0a2d2d81
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9wIvd1bMLOzuR7rKYoHMp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability locus-nyc-recording-history-0a2d2d81 -d '<json body>'
```

Example prompt: Pull the NYC recording history for 123 Main Street, Brooklyn — show me the last 25 recorded documents including deed transfers, mortgages, and liens so I can review the title chain before making an offer.

## When to prefer this

Use this endpoint when you need official NYC land record history — deed transfers, mortgages, liens, and other recorded instruments — for a specific property identified by BBL or street address. It is specifically scoped to New York City's ACRIS recording system and is ideal for pre-offer due diligence, title research, tax appeals, and fraud detection on NYC properties. Prefer this over generic property lookup endpoints when you need the chronological chain of recorded documents rather than current ownership snapshot alone.

## Known failure modes

- Invalid BBL format (must be 10-digit string matching borough 1-5) returns validation error
- Address not resolvable to a NYC property returns empty or error response
- Limit out of range (must be 1-50) returns validation error
- Property with no recorded documents returns empty records array
- Payment failure (insufficient USDC) blocks request
- Upstream ACRIS data temporarily unavailable causes service error

## How this service works

Research one property or compare a shortlist before a showing, offer, project, or tax appeal. Run free public-record checks, then buy deeper x402 reports with ready-to-run next steps.

## Output

A JSON object containing an array of recorded documents associated with the property (deed transfers, mortgages, liens, satisfactions, etc.), each with transaction metadata such as document type, recording date, and parties involved, plus a generatedAt timestamp and any applicable caveats.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bbl": {
   "type": "string",
   "pattern": "^[1-5]\\d{9}$"
  },
  "limit": {
   "type": "integer",
   "default": 25,
   "maximum": 50,
   "minimum": 1
  },
  "address": {
   "type": "string",
   "maxLength": 200,
   "minLength": 5
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "locus_example",
  "caveats": [
   "Example artifact; not live data."
  ],
  "records": [],
  "generatedAt": "2026-01-01T00:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/locus-nyc-recording-history-0a2d2d81/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.locus.report](https://www.zero.xyz/host/api.locus.report/llms.txt)