---
title: "Promise Land Appraisal REST API reference"
description: "Anonymous, read-only REST API reference for business identity, appraisal services, coverage guidance, and published guides."
canonical: "https://promiselandappraisals.com/api/"
last-updated: "2026-11-15"
---

# Promise Land Appraisal REST API reference

The API provides anonymous, read-only access to business identity, residential appraisal services, Greater Houston service-area guidance, request requirements, and public guides.

- Base URL: `https://promiselandappraisals.com/api/v1`
- Authentication: none; no account, key, OAuth token, or permission scope is required
- Response format: JSON over HTTPS
- Version: `v1`; breaking changes use a new major path version
- [OpenAPI specification](https://promiselandappraisals.com/openapi.json)
- [Developer quick start](https://promiselandappraisals.com/developers/)
- [AI assistant guide](https://promiselandappraisals.com/agents/)
- [MCP server guide](https://promiselandappraisals.com/mcp/)
- [RFC 9727 API catalog](https://promiselandappraisals.com/.well-known/api-catalog)

## Endpoints

| Method | Path | Purpose |
| --- | --- | --- |
| `GET` | `/api/v1` | Read API information and limitations |
| `GET` | `/api/v1/health` | Check API availability |
| `GET` | `/api/v1/business` | Read business identity and contact details |
| `GET` | `/api/v1/services` | List residential appraisal services |
| `GET` | `/api/v1/service-areas` | List city pages and address-confirmation guidance |
| `GET` | `/api/v1/request-information` | Read what a person can include in a request |
| `GET` | `/api/v1/guides` | List public Markdown guides |
| `GET` | `/api/v1/guides/{slug}` | Read one published guide |
| `POST` | `/api/v1/search` | Search guides with a general question |

List endpoints return `data` and `pagination`. Use the optional `limit` parameter (1–50) and the `pagination.nextCursor` value for the next page. Omit `cursor` on the first request.

Guide search accepts a JSON object such as `{"query":"How are appraisal fees quoted?"}`. The search question is processed in memory and is not retained. Do not send an address, phone number, or email address.

The API does not accept appraisal requests, confirm coverage for a specific address, value a property, estimate a fee, book work, or take payments. It has no write operations or request database. A visitor must contact Alex Mathew to discuss an assignment.

The A2A information endpoint at `https://promiselandappraisals.com/a2a` supports protocol version `1.0`. Send the `A2A-Version: 1.0` HTTP header with JSON-RPC `SendMessage` requests.

## Errors and limits

Errors use JSON with a stable `code`, a human-readable `message`, and a `resolution` hint. Rate-limit responses use HTTP 429, `Retry-After`, and `RateLimit-Limit`, `RateLimit-Remaining`, and `RateLimit-Reset` headers.

The API is versioned in its URL. Additive fields may be added within a version. Breaking changes will use a new major version, with the existing version supported for at least 12 months after a replacement is announced.

## Contact

Call or text (832) 726-4841 or email ahouseinspect@gmail.com. The public API does not relay contact details or create an assignment.
