# First American Financial

> First American Financial Corporation (NYSE: FAF) provides title insurance, settlement
> services, property data and risk solutions for real estate and mortgage transactions.
> Its public API surface is the **Digital Gateway** (developer.firstam.io), a 3scale-managed
> developer portal operated by First American Mortgage Solutions / First American Data &
> Analytics, publishing 16 machine-readable API specifications across title & settlement,
> property data, ownership, identity, verification and regulatory compliance. Sandbox and
> production access both require an approved account and an App ID / App Key credential pair.

## APIs

- [Title & Settlement (Mortgage Services)](https://developer.firstam.io/api/TitleSettlement): OpenAPI 3.0.0, 17 operations — open/cancel orders, exchange documents and messages, find offices, look up escrow and title officers, and register webhooks for order milestones. Bearer JWT via OAuth 2.0 client credentials.
- [Property](https://developer.firstam.io/api/property): Swagger 2.0, 10 operations — property basic/extended data, property overview, listing history, local market trends, nearby active listings, HOA and FEMA flood.
- [Ownership](https://developer.firstam.io/api/property): Swagger 2.0, 16 operations — full/prime ownership, address, details, pre-foreclosure, foreclosure, previous foreclosure and scheduled REO.
- [Identity](https://developer.firstam.io/api/verification): Swagger 2.0, 5 operations — SSN search, SSN verification, SSN report and SSN report plus.
- [Bankruptcy](https://developer.firstam.io/api/verification): Swagger 2.0, 4 operations — basic, extended and premium bankruptcy searches.
- [4506-C](https://developer.firstam.io/api/verification): Swagger 2.0, 5 operations — IRS tax transcript order, consent form, transcript retrieval (JSON and PDF) and status.
- [Income Estimate (SalaryComp)](https://developer.firstam.io/api/verification): Swagger 2.0, 2 operations.
- [Reverse Phone](https://developer.firstam.io/api/verification): Swagger 2.0, 2 operations.
- [Reverse Address](https://developer.firstam.io/api/verification): Swagger 2.0, 3 operations — basic and detailed.
- [SCRA](https://developer.firstam.io/api/verification): Swagger 2.0, 2 operations — Servicemembers Civil Relief Act status.
- [Liens & Judgments FCRA](https://developer.firstam.io/api/fraudsolutions): Swagger 2.0, 2 operations.
- [Liens & Judgments Non-FCRA](https://developer.firstam.io/api/fraudsolutions): Swagger 2.0, 2 operations.
- [Watchlist](https://developer.firstam.io/api/regulatorycompliance): Swagger 2.0, 8 operations — OFAC, Freddie Mac, FHFA SCP, HUD EPLS, HUD LDP, NFPD and ineligible list screening.
- [NMLS](https://developer.firstam.io/api/regulatorycompliance): Swagger 2.0, 9 operations — company and individual lookup and search.
- [Occupancy](https://developer.firstam.io/api/property): Swagger 2.0, 3 operations — occupancy report, PDF report and order.
- [ClearSearch](https://developer.firstam.io/api/TitleSettlement): Swagger 2.0, 3 operations — order, status and report.

## Specs

- [Digital Gateway ActiveDocs catalogue](https://developer.firstam.io/api_docs/services.json): the machine-readable index of all 16 published specifications.
- Harvested copies of every specification live under `openapi/` in this repository; the verbatim originals are in `openapi/_original/`.

## Docs

- [Digital Gateway developer portal](https://developer.firstam.io/)
- [Documentation overview](https://developer.firstam.io/api/docs)
- [Getting started](https://developer.firstam.io/api/getstarted)
- [Sign up](https://developer.firstam.io/signup) — account is reviewed by an administrator; access granted within 1-2 business days
- [First American Title developer portal](https://developer.firstam.com) — a separate request-access form for the title & settlement integration
- [Support](https://www.firstam.com/mortgagesolutions/support.html)
- [Terms of use](https://www.firstam.com/terms-of-use/)
- [Privacy policy](https://www.firstam.com/privacy-policy/)

## Conventions

- Authentication is an `x-app-id` / `x-app-key` header pair on the Digital Gateway data services, and a bearer JWT obtained from an OAuth 2.0 client-credentials token endpoint on Title & Settlement.
- Most operations are POST even for reads, because search criteria are sensitive and are kept out of the query string.
- Data services follow an order-then-retrieve pattern: `POST /<service>/order` returns a transaction identifier, `GET /<service>/report` retrieves the result.
- Documented status codes: 200 success, 400 invalid request, 401 invalid App ID or App Key, 500 system error, 503 usage limit exceeded.
- Order milestones are delivered by webhook; 21 event types are documented on the Title & Settlement webhook registration operation.

## Notes

- This file is GENERATED by API Evangelist from this repository's artifacts. First American does not publish an llms.txt: `https://developer.firstam.com/llms.txt` returns HTTP 200 with a 28-byte HTML "Not Authorized" body (see `llms/first-american-financial-llms-probe.yml`).