Name: PermitZone API
Brand: nicheapi-llc-1
SKU: api-nicheapi-llc-1-permitzone
Availability: InStock
Author: API Market

True Scary Stories

# PermitZone API

## Overview
The PermitZone API provides a unified, programmatic interface for permit research across jurisdictions and project types. Submit an address and project type, and the API returns the exact permits required, estimated costs and approval timelines, zoning compliance details, common rejection reasons, and a complete document checklist — all in a single structured JSON response. The API currently covers 5 built-in jurisdictions (New York City, Los Angeles, Chicago, Houston, and Phoenix) across project types including restaurant, solar, residential, commercial, and short-term rental. Full-text search, pagination, and bulk analysis up to 50 queries per request are supported across all plans.

## Features

*   **Full Permit Analysis**: A single POST call returns all required permits for a given address and project type, including agency, estimated cost, average approval time, renewal schedule, and rejection rate.
*   **Zoning Compliance**: Each analysis includes the applicable zoning district, use permissions, overlay conditions, setback requirements, and height limits for the submitted address.
*   **Rejection Insights**: Returns the most common rejection reasons per permit per jurisdiction, so applicants can address issues before filing.
*   **Document Checklists**: Every permit in a result set includes the exact documents required for submission.
*   **Cost & Timeline Estimates**: Aggregate estimated total cost and total approval days across all required permits, alongside per-permit breakdowns.
*   **5 Built-In Jurisdictions**: New York City, Los Angeles, Chicago, Houston, and Phoenix — with jurisdiction, project type, permit, zoning, and document data accessible via dedicated GET endpoints.
*   **Full-Text Search**: Filter records by keyword across all list endpoints using the `?q=` query parameter.
*   **Pagination Support**: Manage data retrieval with `?limit=` (max 1000) and `?offset=` parameters across all list endpoints.
*   **Batch Analysis**: Submit up to 50 address and project type queries in a single request.
*   **High Availability**: A rate limit of 60 requests per minute across all plans.

## Use Cases

The PermitZone API is suited for a range of development, compliance, and feasibility workflows:

*   **Real Estate Developers**: Run permit feasibility analysis during site selection — before committing to a project — by submitting an address and project type to surface all required permits, costs, and zoning conditions in a single call.
*   **Small Business Owners**: Identify every city occupancy and health permit required to open a restaurant, retail space, or service business at a specific address, with exact document requirements and common rejection pitfalls.
*   **Solar & EV Charger Installers**: Retrieve all electrical, building, and utility permits required for a given installation address, reducing the research burden across jurisdictions with different rules.
*   **Franchise Operators**: Use batch analysis to screen multiple candidate locations across jurisdictions simultaneously, comparing permit burden, cost, and timeline before committing to a site.
*   **Short-Term Rental Hosts**: Verify local STR licensing requirements, zoning permissions, and renewal schedules for a specific address before listing a property.
*   **Architecture & Engineering Firms**: Automate permit feasibility studies during early project phases using programmatic access to jurisdiction, zoning, and permit data.


## API Documentation

### Base URL
All API requests for the PermitZone API should be made to the following base URL:
`https://prod.api.market/api/v1/nicheapi-llc-1/permitzone/permitzone`

### Authentication
Authentication is handled via an API key. Include your key in the `x-api-market-key` header of every request:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key. A single key provides access to all 415+ APIs available through the platform.


### Endpoints

#### 1. Analyze a Project

Submit an address and project type for full permit analysis. Returns all required permits, zoning compliance, document checklists, rejection insights, and aggregate cost and timeline estimates.

**Method**: `POST`
**Endpoint**: `/permitzone/analyze`

**Request Body**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `address` | body | Full street address of the project location | `string` | Yes |
| `project_type` | body | Type of project (e.g., `"restaurant"`, `"solar"`, `"residential"`, `"commercial"`, `"str"`) | `string` | Yes |
| `square_footage` | body | Project square footage, used to refine permit and fee estimates where applicable | `integer` | No |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/permitzone/permitzone/analyze" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "123 Main St, New York, NY",
    "project_type": "restaurant",
    "square_footage": 1500
  }'
```

**Example Response (200 OK)**:

```json
{
  "jurisdiction": "new-york-city",
  "project_type": "restaurant",
  "required_permits": [
    {
      "id": "nyc-food-service",
      "name": "Food Service Establishment Permit",
      "agency": "NYC DOHMH",
      "estimated_cost": 280,
      "avg_approval_days": 30,
      "renewal": "annual",
      "rejection_rate_pct": 8,
      "top_rejection_reasons": [
        "Improper grease trap installation",
        "Inadequate ventilation plans"
      ],
      "required_documents": [
        "Menu with pricing",
        "Floor plan (sealed)",
        "Grease trap specification",
        "Health department application form"
      ]
    }
  ],
  "zoning_check": {
    "zoning_district": "C2-4",
    "restaurant_allowed": true,
    "conditions": [
      "Seating capacity limited to fire code occupancy",
      "No drive-through in this district"
    ],
    "setback_feet": 0,
    "max_height_feet": 85
  },
  "estimated_total_cost": 1875,
  "estimated_total_days": 75,
  "confidence_score": 87
}
```

#### 2. Batch Analyze Projects

Submit up to 50 address and project type queries in a single request for bulk permit analysis.

**Method**: `POST`
**Endpoint**: `/permitzone/analyze/batch`

**Request Body**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `queries` | body | Array of analysis objects, each containing `address`, `project_type`, and optional `square_footage` (max 50) | `array` | Yes |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/permitzone/permitzone/analyze/batch" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "queries": [
      {"address": "123 Main St, New York, NY", "project_type": "restaurant", "square_footage": 1500},
      {"address": "456 Sunset Blvd, Los Angeles, CA", "project_type": "solar"}
    ]
  }'
```

#### 3. Run Test Scenarios

Run permit analysis against built-in sample scenarios across diverse project types and jurisdictions.

**Method**: `POST`
**Endpoint**: `/permitzone/test`

**Request Body**:

| Name | In | Description | Type | Required | Default |
| :--- | :--- | :--- | :--- | :--- | :--- |
| `count` | body | Number of sample scenarios to run | `integer` | No | `1` |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/permitzone/permitzone/test" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count": 3}'
```

#### 4. List Jurisdictions

Retrieve a paginated list of supported jurisdictions.

**Method**: `GET`
**Endpoint**: `/permitzone/jurisdictions`

**Parameters**:

| Name | In | Description | Type | Required | Default | Max Value |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `q` | query | Search query to filter jurisdictions by keyword | `string` | No | | |
| `limit` | query | Maximum number of results | `integer` | No | `50` | `1000` |
| `offset` | query | Number of results to skip for pagination | `integer` | No | `0` | |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/permitzone/permitzone/jurisdictions" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 5. Get Jurisdiction by ID

Retrieve details for a specific jurisdiction.

**Method**: `GET`
**Endpoint**: `/permitzone/jurisdictions/{id}`

**Parameters**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `id` | path | Unique identifier for the jurisdiction record | `string` | Yes |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/permitzone/permitzone/jurisdictions/new-york-city" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 6. List Project Types

Retrieve a paginated list of recognized project types.

**Method**: `GET`
**Endpoint**: `/permitzone/project-types`

**Parameters**:

| Name | In | Description | Type | Required | Default | Max Value |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `q` | query | Search query to filter project types by keyword | `string` | No | | |
| `limit` | query | Maximum number of results | `integer` | No | `50` | `1000` |
| `offset` | query | Number of results to skip for pagination | `integer` | No | `0` | |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/permitzone/permitzone/project-types" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 7. Get Project Type by ID

Retrieve details for a specific project type.

**Method**: `GET`
**Endpoint**: `/permitzone/project-types/{id}`

**Parameters**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `id` | path | Unique identifier for the project type record | `string` | Yes |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/permitzone/permitzone/project-types/restaurant" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 8. List Permits

Retrieve a paginated list of all permits across jurisdictions.

**Method**: `GET`
**Endpoint**: `/permitzone/permits`

**Parameters**:

| Name | In | Description | Type | Required | Default | Max Value |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `q` | query | Search query to filter permits by keyword | `string` | No | | |
| `limit` | query | Maximum number of results | `integer` | No | `50` | `1000` |
| `offset` | query | Number of results to skip for pagination | `integer` | No | `0` | |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/permitzone/permitzone/permits?q=electrical&limit=10" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 9. Get Permit by ID

Retrieve details for a specific permit record.

**Method**: `GET`
**Endpoint**: `/permitzone/permits/{id}`

**Parameters**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `id` | path | Unique identifier for the permit record | `string` | Yes |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/permitzone/permitzone/permits/nyc-food-service" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 10. List Zoning Regulations

Retrieve a paginated list of zoning regulations across jurisdictions.

**Method**: `GET`
**Endpoint**: `/permitzone/zoning`

**Parameters**:

| Name | In | Description | Type | Required | Default | Max Value |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `q` | query | Search query to filter zoning records by keyword | `string` | No | | |
| `limit` | query | Maximum number of results | `integer` | No | `50` | `1000` |
| `offset` | query | Number of results to skip for pagination | `integer` | No | `0` | |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/permitzone/permitzone/zoning?q=commercial&limit=10" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 11. Get Zoning Record by ID

Retrieve details for a specific zoning regulation record.

**Method**: `GET`
**Endpoint**: `/permitzone/zoning/{id}`

**Parameters**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `id` | path | Unique identifier for the zoning record | `string` | Yes |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/permitzone/permitzone/zoning/nyc-c2-4" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 12. List Document Requirements

Retrieve a paginated list of document requirements across all permits and jurisdictions.

**Method**: `GET`
**Endpoint**: `/permitzone/documents`

**Parameters**:

| Name | In | Description | Type | Required | Default | Max Value |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `q` | query | Search query to filter document records by keyword | `string` | No | | |
| `limit` | query | Maximum number of results | `integer` | No | `50` | `1000` |
| `offset` | query | Number of results to skip for pagination | `integer` | No | `0` | |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/permitzone/permitzone/documents?q=floor+plan&limit=10" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 13. Get Document Requirements by ID

Retrieve the document requirements for a specific permit.

**Method**: `GET`
**Endpoint**: `/permitzone/documents/{id}`

**Parameters**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `id` | path | Unique identifier for the document requirement record | `string` | Yes |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/permitzone/permitzone/documents/nyc-food-service" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 14. Health Check

Check API availability and retrieve a list of available endpoints.

**Method**: `GET`
**Endpoint**: `/permitzone/health`

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/permitzone/permitzone/health" \
  -H "x-api-market-key: YOUR_API_KEY"
```


## Status Codes
Below is a list of common HTTP status codes you may encounter when interacting with the PermitZone API:

*   **`200 OK`**: The request was successful and the server has returned the requested data.
*   **`400 Bad Request`**: The server could not process the request due to invalid input — such as a missing `address` or `project_type` field, an unrecognized project type value, or a batch array exceeding 50 queries. Review your request body before retrying.
*   **`401 Unauthorized`**: Authentication failed. Your `x-api-market-key` header is missing or contains an invalid key. Confirm your key is active and correctly included in the request header.
*   **`404 Not Found`**: The requested endpoint or record ID does not exist. Verify the URL path and resource ID against the endpoint reference above.
*   **`429 Too Many Requests`**: You have exceeded the rate limit of 60 requests per minute. Implement client-side rate limiting and exponential backoff. Check the `Retry-After` response header for guidance on when to retry.
*   **`500 Internal Server Error`**: An unexpected server-side error occurred. Retry the request after a short delay.

## Rate Limits
The PermitZone API enforces a rate limit of **60 requests per minute** across all plans.

If you exceed this limit, the API returns a `429 Too Many Requests` status code. Implement exponential backoff in your client and monitor the `Retry-After` header for retry timing guidance.

## FAQ

*   **Which jurisdictions are currently supported?**
    The API currently includes built-in data for New York City, Los Angeles, Chicago, Houston, and Phoenix. Use the `/permitzone/jurisdictions` endpoint to retrieve the full list and filter by keyword.

*   **Which project types are recognized?**
    Supported project types include restaurant, solar, residential, commercial, and short-term rental (STR). Use the `/permitzone/project-types` endpoint to browse all available types.

*   **What does the confidence score in the analyze response represent?**
    The `confidence_score` (0–100) reflects how precisely the returned permit and zoning data maps to the submitted address and project type, based on data coverage and address resolution quality for that jurisdiction.

*   **How many queries can I batch analyze at once?**
    The `/permitzone/analyze/batch` endpoint accepts up to 50 queries per request.

*   **Can I look up permits, zoning records, and document requirements without submitting an address?**
    Yes. The reference data endpoints — `/permits`, `/zoning`, `/documents`, `/jurisdictions`, and `/project-types` — provide direct access to the underlying dataset and support full-text search via `?q=` and pagination via `?limit=` and `?offset=`.

*   **How do I authenticate my requests?**
    All requests require an `x-api-market-key` header. A single API key provides access to all 415+ APIs available through the platform.

*   **What is the rate limit?**
    The API enforces a limit of 60 requests per minute across all plans. See the Rate Limits section for handling guidance.

## Contact Us

If you have any questions or need assistance, you can reach out through the embedded chat on the bottom right corner of the page or send an email to 21truescarystories@gmail.com.

Programmatic interface for permit research across jurisdictions and project types

PermitZone API

Free