---
title: "Exact parcel lookup (UUID or APN)"
method: GET
path: "/api/v1/lookup"
tags: ["Parcels"]
---

# Exact parcel lookup (UUID or APN)

`GET /api/v1/lookup`

## Request

- Base URL: `https://propraven.com`
- URL: `https://propraven.com/api/v1/lookup`
- Auth: one of:
  - HTTP bearer
  - none

Resolve one parcel from an exact key: a PropRaven parcel UUID or an APN. Answered from the search index (the `parcel` fields are a subset of GET /parcels/{id}). Anonymous callers are IP-throttled on the restricted budget (100/day); fuzzy address input needs a key and is answered by POST /lookup/batch.

## Query parameters

- `q` string, required

## Response `200`

The matched parcel.

- object
  - `found` boolean, nullable, required
  - `query` string, nullable, required
  - `parcel` object, required
    - `id` string, required
    - `apn` string, nullable, required
    - `county_fips` string, required
    - `state_fips` string, required
    - `address` string, nullable, required
    - `city` string, nullable, required
    - `zip` string, nullable, required
    - `latitude` number, nullable, required
    - `longitude` number, nullable, required
    - `total_assessed_value` integer, nullable, required
    - `last_sale_price` number, nullable, required
    - `land_use_code` string, nullable, required
    - `owner_name` string, nullable, required

## Other responses

- `400`: A query or body parameter is invalid. Nothing was read or charged.
- `401`: Missing, malformed or invalid credential.
- `404`: The resource (or the endpoint) does not exist.
- `405`: The endpoint exists but does not support this method. `Allow` lists the methods it does.
- `429`: Rate limit exceeded.
- `500`: Unexpected server error. The body never carries database or driver text.

---

[API](https://skmtc.dev/propraven/apis/propraven-api.md) · [All operations](https://skmtc.dev/propraven/apis/propraven-api/llms.txt) · [OpenAPI document](https://skmtc.dev/propraven/apis/propraven-api/revisions/37f8158c4eda?raw)