Skip to main content
GET
/
v1
/
permits
/
search
Search permits for a geo scope
curl --request GET \
  --url https://api.homelogs.io/v1/permits/search \
  --header 'X-API-Key: <api-key>'
{
  "geo_id": "<string>",
  "permits": [
    {
      "permit_id": "<string>",
      "permit_type": "<string>",
      "status": "<string>",
      "issue_date": "2023-12-25",
      "location": {
        "full_address": "<string>",
        "city": "<string>",
        "state": "<string>",
        "zipcode": "<string>",
        "county": "<string>",
        "jurisdiction": "<string>"
      },
      "geo_match": {
        "geo_id": "<string>",
        "geo_type": "<string>",
        "confidence": 123
      },
      "completion_date": "2023-12-25",
      "raw_description": "<string>",
      "source": "<string>"
    }
  ],
  "next_cursor": "<string>"
}
Returns permit rows for a geo_id, with cursor-based pagination. Use this endpoint when you want raw permit records (not pre-filtered lead rows).
For lead-ready timing signals, use Permit Signal Leads.

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
geo_id
string
required
Example:

"geo_city_0200d4df17d3b8cd84c6"

​
from_date
string<date>
​
to_date
string<date>
​
status
string
​
permit_type
string
​
sort
enum<string>
default:desc
Available options:
asc,
desc
​
limit
integer
default:25
Required range: 1 <= x <= 100
​
cursor
string

Response

Permit page.

​
geo_id
string
required
​
permits
object[]
required
​
next_cursor
string | null
required