---
title: "One building permit"
method: GET
path: "/api/permits/{id}"
tags: ["Building permits"]
---

# One building permit

`GET /api/permits/{id}`

## Request

- Base URL: `https://noozra.com`
- URL: `https://noozra.com/api/permits/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/noozra/apis/noozra-news-api/docs/api/permits/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

One record, in the shape `/api/permits` lists it. Without API Pro, one dated in the last 14 days; with it, any record.

## Path parameters

- `id` string, uuid, required

## Response `200`

OK

- Permit
  - `amount` number, nullable, required: Dollars.
  - `city` string, required: The city's slug.
  - `contractor` string, nullable, required
  - `date` string, date, required: YYYY-MM-DD: the day the permit was issued.
  - `description` string, nullable, required: The source's own text, at most 1000 characters.
  - `id` string, uuid, required
  - `kind` 'commercial' | 'residential' | 'other', required
  - `permit_type` string, nullable, required
  - `place` Place, required
    - `address` string, nullable, required
    - `city` string, nullable, required
    - `country` string, nullable, required: ISO 3166-1 alpha-3, such as USA.
    - `latitude` number, nullable, required
    - `longitude` number, nullable, required
    - `state` string, nullable, required: Two-letter state.
    - `zip` string, nullable, required
  - `reference` string, required: The record's own number at its source.
  - `source` string, required: Who published the record. Name it when you show the record.
  - `status` string, nullable, required
  - `url` string, uri, nullable, required: The record at its source; for a city record without a page of its own, the city's dataset.

## Other responses

- `400`: Not a UUID
- `401`: No API key, or an invalid or revoked one
- `404`: Unknown id (or, without API Pro, a record outside the free reach)
- `429`: Daily rate limit exceeded (honor the Retry-After header)

## Changes

- **2026-10-29** `e0c2d7df6d6f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/noozra/apis/noozra-news-api/changes/api/permits/:id/get.md)

---

[API](https://skmtc.dev/noozra/apis/noozra-news-api.md) - [All operations](https://skmtc.dev/noozra/apis/noozra-news-api/llms.txt) - [OpenAPI document](https://skmtc.dev/noozra/apis/noozra-news-api/revisions/9067da767e84?raw)