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

# NYC housing code violations

> Retrieve housing maintenance code violations recorded by NYC HPD for one tax lot.

Retrieve housing maintenance code violations recorded by NYC HPD for one tax lot.

**Operation ID:** `real_estate.violations`. **Family:** [Real Estate & Assets](https://docs.altss.com/console/families/real-estate-assets.md).

[Read the live operation contract (JSON)](https://console.altss.com/v1/console/capabilities/real_estate.violations) for the current input and output schemas, price, limits and required scopes.

**Status:** Available (`AVAILABLE`). **Supported interfaces:** REST, MCP.

**Commercial status:** Available. Receive the structured result and receipt in Console after the run settles.

**Execution interfaces:** UI, REST, MCP.

## When to use it

Look up housing maintenance code violations for one New York City tax lot. Each entry includes the inspection date and the agency’s latest reported status.

## Price and billing unit

Request a quote for one NYC housing code violations. Review its inputs, delivery plan, use terms and maximum charge before accepting. Retrying the same purchase uses the same idempotency key.

**Price:** \$0.10. **Billing unit:** per delivered violation history.

**Charge condition:** The authorized execution delivers a validated result and settles once. Failed pre-settlement executions are not charged; reservation release must be confirmed. Retrieve the same run if charge state is uncertain.

**Execution budget:** Maximum \$0.10 per accepted execution.

Fund your Console wallet, review the quote and approve the charge before execution.

## Inputs

Exact ten-digit NYC borough-block-lot number (BBL)

```json theme={null}
{
  "type": "object",
  "properties": {
    "bbl": {
      "type": "string",
      "pattern": "^[1-5]\\d{9}$"
    }
  },
  "required": [
    "bbl"
  ],
  "additionalProperties": false
}
```

## Result and output schema

Up to 25 violation IDs, classes, inspection dates and reported current statuses

```json theme={null}
{
  "$ref": "https://console.altss.com/openapi.json#/components/schemas/Result_real_estate_violations"
}
```

## Examples

Illustrative request and result for this scope. The names, values and record references are examples. Actual delivery depends on the published availability and agreed scope.

### Example input

```json theme={null}
{
  "bbl": "1003770050"
}
```

### Example structured output

```json theme={null}
{
  "kind": "NYC_HOUSING_VIOLATIONS",
  "violations": [
    {
      "violationId": "17945140",
      "classification": "A",
      "inspectionDate": "2025-06-04",
      "status": "VIOLATION DISMISSED",
      "statusDate": "2025-06-27"
    }
  ]
}
```

## API example and execution

[Verified production contract](https://console.altss.com/openapi.json) · Base URL: `https://console.altss.com/v1/console`. Quote first. Obtain explicit approval of the price, plan and use terms before sending accept:true. Reuse the same purchase idempotency key on retries.

Required scope: `company.read`. Organization authority, funding checks and spending limits apply to paid execution.

Supply credentials in the documented authorization header. Replace a placeholder run ID with an actual authorized run ID.

```json theme={null}
{
  "method": "POST",
  "url": "https://console.altss.com/v1/console/quote",
  "body": {
    "toolId": "real_estate.violations",
    "input": {
      "bbl": "1003770050"
    }
  }
}
```

This example requests a quote. A paid run requires the unchanged returned quote, explicit acceptance and a stable idempotency key.

## MCP and A2A

**Supported interfaces:** REST, MCP. Current MCP tools: `altss_quote`, `altss_run`, `altss_get_run`. Inspect tools/list and inputSchema before use. Paid A2A execution is unavailable. The separate anonymous A2A reader serves public information.

[REST guide](https://docs.altss.com/console/rest.md) · [MCP guide](https://docs.altss.com/console/mcp.md) · [A2A scope](https://docs.altss.com/console/a2a.md) · [Authentication and credentials](https://docs.altss.com/console/authentication.md)

## Sources, evidence and freshness

* Public records and official sources
* Altss intelligence and source collections

Retain source attribution, observation and event dates, evidence and explicit unknowns where supplied. A record update is not independent verification.

Historical source collection dates describe when the material was observed. Coverage and freshness depend on each returned source. Preserve its observation date and use restrictions with the result.

## Limits and permitted use

* Includes: Get up to 25 published housing maintenance code violations for one NYC tax lot, with inspection dates and the latest reported status.; Publishing agency, reproducible source URL and retrieval time. Excludes: Parties, contacts, title determinations and property appraisals. Requires scope company.read. Source: public property register.
* A timeout does not establish the final charge. Retrieve the existing run before retrying.

Use is limited by the accepted quote or agreed delivery scope, source restrictions and privacy controls. Storage, attribution, retention, redistribution and training permissions do not expand through normalization.

## Next step

[Try Console](https://console.altss.com/signup?src=buyer-intent\&cta=capability\&capability=real_estate.violations) · [Open Console workspace](https://console.altss.com/console/playground/new?capability=real_estate.violations) · [View the capability on Altss](https://altss.com/console/capabilities/real_estate.violations) · [Wallet and billing](https://docs.altss.com/console/billing.md)

[Back to Real Estate & Assets](https://docs.altss.com/console/families/real-estate-assets.md) · [All capabilities](https://docs.altss.com/console/capabilities.md) · [Price schedule](https://docs.altss.com/console/prices.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.