Skip to main content
The canonical_uid path segment is malformed.
400 application/problem+json
Every PermitCore error is RFC 9457 application/problem+json. Branch on type (a stable URI), not on title or detail (human-readable, may change).

​
When it occurs

The path segment could be read but does not conform to the {jurisdiction_id}:{source_permit_id} shape (e.g. missing the : separator, or a non-numeric jurisdiction_id). Real values contain :, |, spaces, and /, so they MUST be encodeURIComponent-escaped.

​
How to fix

URL-encode the full canonical_uid before placing it in the path and confirm it has the {jurisdiction_id}:{source_permit_id} form. See Get a permit by canonical_uid. Not retryable — fix the request before resubmitting; retrying unchanged returns the same error. See the full error catalog for the response shape and retry matrix. Every response carries an x-request-id header — include it in any support request.