API Documentation
RESTful JSON API. Standard Bearer token authentication. Detailed response schemas.
Base URL
https://api.parcelbase.ai/api/v1Authentication
Include your API key in the Authorization header with every request:
Authorization: Bearer YOUR_API_KEYEndpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /property/address | Lookup by street address + city + state |
| GET | /property/detail | Full property detail (same as address lookup) |
| GET | /property/owner | Search by owner last name |
| GET | /property/parcel | Search by APN / parcel ID |
| GET | /sale/detail | Most recent sale information |
| GET | /sale/history | Full sales transaction history |
| GET | /assessment/detail | Tax assessment details and history |
| GET | /health | API health check (no auth required) |
| GET | /usage | Your API key usage statistics |
Property Address Lookup
Search by address, city, and state. Optionally include ZIP code for precision.
| Parameter | Type | Required | Description |
|---|---|---|---|
| address | string | Conditional | Full street address (e.g. 3925 Malibu Vista Dr) |
| number | string | Conditional | Street number only |
| city / locality | string | Conditional | City name |
| state / countrySubd | string | Conditional | Two-letter state code |
| zip / postal1 | string | Optional | 5-digit ZIP code |
| page | integer | Optional | Page number (default 1) |
| pagesize | integer | Optional | Results per page (max 25) |
Example Request
curl -H "Authorization: Bearer YOUR_API_KEY" \\n "https://api.parcelbase.ai/api/v1/property/address?address=3925+Malibu+Vista+Dr&city=Malibu&state=CA"Response Structure
Every response includes a status object and a property array. Each property contains nested objects for address, location, owner, building, lot, assessment, sale, and mortgage data.
{\n "status": { "code": 0, "msg": "Success", "total": 1, "page": 1, "pagesize": 25 },\n "property": [{\n "identifier": { "Id": 10483921, "fips": "06037", "apn": "4469-018-005" },\n "address": { "oneLine": "3925 Malibu Vista Dr", "locality": "Malibu", "countrySubd": "CA", "postal1": "90265" },\n "location": { "latitude": 34.021, "longitude": -118.779, "county": "Los Angeles" },\n "summary": { "proptype": "Single Family", "yearbuilt": 1998, "absenteeInd": "N" },\n "building": { "size": { "universalsize": 4200 }, "rooms": { "beds": 5, "bathstotal": 4 } },\n "lot": { "lotsize1": 32500, "lotsize2": 0.75, "pooltype": "Y" },\n "owner": {\n "owner1": { "fullName": "John A Smith", "firstName": "John", "lastName": "Smith", "type": "Individual" },\n "mailingAddress": { "line1": "3925 Malibu Vista Dr", "locality": "Malibu", "countrySubd": "CA" }\n },\n "assessment": { "assessed": { "total": 3800000 }, "market": { "total": 4250000 }, "avm": { "value": 4180000 } },\n "sale": { "lastSale": { "price": 3900000, "date": "2021-06-15" } },\n "mortgage": { "amount": 2800000, "lender": { "companyname": "Wells Fargo" } }\n }]\n}Error Codes
| Code | HTTP Status | Description |
|---|---|---|
| 0 | 200 | Success |
| 400 | 400 | Invalid or missing parameters |
| 401 | 401 | Invalid or missing API key |
| 403 | 403 | API key disabled |
| 404 | 404 | No properties found |
| 429 | 429 | Rate limit or daily quota exceeded |
Full OpenAPI 3.0 specification available at /openapi.yaml. For RapidAPI users, the X-RapidAPI-Key header is also accepted for authentication.