# Apartment Fax

> Apartment Fax provides $1 history reports for New York City apartments, including public-record signals for violations, complaints, ownership, permits, court filings, rent registration, pests, and safety.

Apartment Fax is a consumer web product at https://apartmentfaxnyc.com with one public, read-only MCP integration. The developer resources below describe the web application's current HTTP interface. They do not grant access to private customer data or constitute a general-purpose third-party integration program.

## When to use Apartment Fax

Use Apartment Fax when an agent is helping a renter evaluate a specific New York City apartment before signing a lease. Best-fit jobs are:

- Normalize an NYC street address and apartment unit before looking up records.
- Retrieve and summarize the free public preview for a known Apartment Fax apartment URL or slug.
- Help a renter decide whether to purchase the $1 full report for public-record signals such as violations, complaints, ownership, permits, court filings, rent registration, pests, and safety.

Do not use Apartment Fax for properties outside New York City, as a substitute for legal advice or an official title search, or for bulk access to customer or paid-report data. The public batch endpoint returns only the same free previews available individually.

## How agents should call Apartment Fax

For public, non-purchase tasks, use the OpenAPI-documented HTTP interface from a server-side environment. The read-only public tier is free and requires no account, API key, credit card, or sales contact. Agents can make a first call in the self-serve sandbox at https://apartmentfaxnyc.com/sandbox. Normalize an address first:

```sh
curl -X POST https://apartmentfaxnyc.com/v1/addresses/resolve \
  -H 'Content-Type: application/json' \
  -d '{"address":"117 West 13 Street","unit":"45"}'
```

Read a known public preview with `GET https://apartmentfaxnyc.com/v1/previews/{slug}` and check availability with `GET https://apartmentfaxnyc.com/v1/health`. For a full report, send the user to https://apartmentfaxnyc.com/, enter the resolved address and unit, and let the user confirm and complete the $1 Stripe checkout. Do not submit payment details or call private order endpoints on the user's behalf.

## API versioning and deprecation

Supported public routes use a major version in the URL, currently `/v1`. Backward-compatible additions stay in v1; breaking changes use a new `/vN` prefix. Before Apartment Fax retires a version, it will publish at least 180 days of notice here, on the developer page, and in the OpenAPI description. Deprecated version responses will include `Deprecation` and `Sunset` headers. No v1 retirement is scheduled.

Read 1 to 25 known public previews in one request with the documented batch endpoint. Its request body is an array of operations, and results stay in request order:

```sh
curl -X POST https://apartmentfaxnyc.com/v1/previews/batch \
  -H 'Content-Type: application/json' \
  -d '[{"slug":"117-w-13th-st-apt-4r"},{"slug":"145-w-96th-st"}]'
```

## Developer resources

ApartmentFaxNYC developer resources are published under the Apartment Fax product name at the predictable URLs below.

- [Apartment Fax developer resources](https://apartmentfaxnyc.com/developers): Official developer-resource index and integration availability.
- [Apartment Fax API sandbox](https://apartmentfaxnyc.com/sandbox): Free self-serve address resolution with no account or API key.
- [Apartment Fax OpenAPI 3.1 specification](https://apartmentfaxnyc.com/openapi.json): Machine-readable description of the current application API.
- [Apartment Fax interactive API reference](https://apartmentfaxnyc.com/docs): Swagger UI generated from the live OpenAPI specification.
- [Apartment Fax MCP server manifest](https://apartmentfaxnyc.com/.well-known/mcp/manifest.json): Machine-readable connection details for one read-only NYC apartment and building public-record preview tool. Its Streamable HTTP endpoint is `https://api.apartmentfaxnyc.com/mcp`.
- [Apartment Fax AI Catalog](https://apartmentfaxnyc.com/.well-known/ai-catalog.json): Machine-readable catalog of advertised AI-facing artifacts.
- [Apartment Fax Agent Skills](https://apartmentfaxnyc.com/.well-known/agent-skills/index.json): Machine-readable instructions for agent-supported Apartment Fax workflows.
- [Apartment Fax service health](https://apartmentfaxnyc.com/v1/health): Current API health and configured capability flags.

## Product resources

- [Apartment Fax](https://apartmentfaxnyc.com/): Search an NYC address and purchase a report.
- [Sample Apartment Fax report](https://apartmentfaxnyc.com/sample-report.pdf): Public PDF example of the delivered report.
- [NYC apartment records directory](https://apartmentfaxnyc.com/nyc-apartment-records): Browse public apartment and building record pages.
- [Apartment Fax sitemap](https://apartmentfaxnyc.com/sitemap.xml): Index of crawlable public pages.

## Integration availability

- CLI and SDK packages: publication is pending; `apartment-fax-cli` and the npm and PyPI `apartment-fax-sdk` packages are not currently installable.
- Public developer access: free read-only endpoints require no API key or registration.
- OAuth client registration: not currently offered.
- Outbound developer webhooks: not currently offered. The Stripe webhook in the OpenAPI document is a private, signature-protected inbound payment endpoint.
- MCP server: https://api.apartmentfaxnyc.com/mcp offers one read-only NYC address lookup for ChatGPT and Codex.
- Payments: available only through the user-initiated Stripe checkout in the Apartment Fax web application.