RetailHardHat Developer docs

REST API documentation

Permits

Permits and licenses required for site development

Supported operations

MethodPathDescription
GET/api/v1/permitsList all permits
GET/api/v1/permits/:idGet a permit by ID
POST/api/v1/permitsCreate a new permit
PATCH/api/v1/permits/:idUpdate a permit
DELETE/api/v1/permits/:idDelete a permit

Example request

Replace YOUR_API_KEY with a private key stored in your environment. Replace path parameters with records from your organization.

curl --request GET "/api/v1/permits" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Accept: application/json"

Field reference

Required means required by the underlying data model, not necessarily caller-supplied. The server derives protected identity and ownership fields; endpoint validation controls which fields are accepted. Sensitive credential fields are omitted here.

FieldTypeModel requirementDescription
idstringOptionalUnique identifier (auto-generated)
siteIduuidRequiredsite Id

Related resource: sites

namestringRequiredname
permitNumberstringOptionalpermit Number
typestringRequiredtype
statusenumOptionalstatus

Values: pending, submitted, under_review, approved, rejected, scheduled

authoritystringOptionalauthority
applicationDatedatetimeRequiredapplication Date
approvalDatedatetimeOptionalapproval Date
expirationDatedatetimeOptionalexpiration Date
notesstringOptionalnotes
representativeContactIduuidOptionalrepresentative Contact Id
createdAtdatetimeOptionalCreation timestamp (auto)
updatedAtdatetimeOptionalLast update timestamp (auto)