Developer API
Build on PermitJunkie
Read-only public knowledge endpoints and authenticated workspace endpoints for partners and integrations. JSON, CORS-enabled, versioned at /api/public/v1.
Authentication
Create an API key in Account → API Keys. Keys are workspace-scoped and shown once. Send them as a Bearer token:
curl https://permitjunkie.com/api/public/v1/me \ -H "Authorization: Bearer pj_your_key_here"
Scopes: read (default) and write. Revoked or expired keys return 401.
Endpoints
GET
/api/public/v1public
API indexGET
/api/public/v1/meauth
Return the authenticated key + workspaceGET
/api/public/v1/workspace/projectsauth
List projects in your workspacePOST
/api/public/v1/workspace/projects/createauth
Create a project (write scope)GET
/api/public/v1/jurisdictionspublic
Search public jurisdictionsGET
/api/public/v1/permitspublic
Search permit catalogGET
/api/public/v1/codespublic
Search code booksGET
/api/public/v1/ordinancespublic
Search ordinancesGET
/api/public/v1/citationspublic
Get code/ordinance citationsResponse shape
All responses use a consistent envelope:
// success
{ "ok": true, "data": { ... } }
// error
{ "ok": false, "error": { "code": "invalid_key", "message": "..." } }Rate limits and per-key usage logs are visible in your Account → API Keys panel.