RESTful API

API Documentation

Integrate ReadyPermit's 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
Starter Plan
5 reports/month
120/min
Professional Plan
50 reports/month
300/min
Portfolio Plan
100 reports/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

// 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

Ready to Build?

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

View Pricing