RESTful API
GPowered by GEO

API Documentation

Integrate ReadyPermit™ property intelligence directly into your applications with our powerful REST API

Getting Started

Base URL

https://api.readypermit.ai/v1

Authentication

All API requests require authentication using your API key in the Authorization header:

Authorization: Bearer your_api_key_here
Keep your API key secure
Never expose your API key in client-side code. Use environment variables and server-side requests only.

Get Your API Key

API access is available for Portfolio plan subscribers. Generate your API key from your account dashboard:

Upgrade to Portfolio Plan

Rate Limits

60/min
Bulk Starter
50 properties/month
120/min
Bulk Pro
200 properties/month
Recommended
300/min
Bulk Enterprise
1,000 properties/month
500/min
Bulk Scale
3,000 properties/month

Rate limits are tracked per API key. If you exceed your limit, you'll receive a 429 status code. Contact landon@readypermit.ai or carson@readypermit.ai for enterprise volume pricing.

Quick Start

Powered by GEO, our AI zoning underwriter

// Install the SDK
npm install @readypermit/sdk

// Initialize the client
const ReadyPermit = require('@readypermit/sdk');
const client = new ReadyPermit({ apiKey: 'your_api_key_here' });

// Generate a property report
const report = await client.reports.create({
  address: '123 Main St, Los Angeles, CA 90210'
});

console.log(report.buildabilityScore);
console.log(report.zoning);

Endpoints

POST/v1/reports

Generate a comprehensive property report

Request Body:

{
  "address": "123 Main St, Los Angeles, CA 90210",
  "include": [
    "zoning",
    "environmental",
    "market"
  ]
}

Response:

{
  "id": "rpt_1234567890",
  "address": "123 Main St, Los Angeles, CA 90210",
  "buildabilityScore": 78,
  "zoning": {
    "code": "R-3",
    "description": "Multi-Family Residential",
    "permittedUses": [
      "Residential",
      "Multi-family dwelling"
    ]
  },
  "status": "completed"
}
GET/v1/reports/:id

Retrieve an existing report

Response:

{
  "id": "rpt_1234567890",
  "address": "123 Main St, Los Angeles, CA 90210",
  "buildabilityScore": 78,
  "status": "completed",
  "createdAt": "2025-01-15T10:30:00Z"
}
GET/v1/geocode

Geocode an address to coordinates

Request Body:

{
  "address": "123 Main St, Los Angeles, CA 90210"
}

Response:

{
  "latitude": 34.0522,
  "longitude": -118.2437,
  "formattedAddress": "123 Main St, Los Angeles, CA 90210"
}

Error Codes

CodeStatusDescription
200OKRequest succeeded
400Bad RequestInvalid request parameters
401UnauthorizedInvalid or missing API key
429Too Many RequestsRate limit exceeded
500Internal Server ErrorServer error, please try again
G

What is GEO?

GEO is a property intelligence engine powered by multi-model AI consensus that emulates a senior zoning underwriter. It aggregates data from 20+ government sources and delivers comprehensive property intelligence in seconds.

20+
Government APIs
3
AI Models
<15s
Avg Response

Ready to Build?

Get API access with a Portfolio plan subscription and start integrating property intelligence today

View Pricing

We use cookies for analytics and to improve your experience. Essential cookies are always active.