Fetch a single form by id.
GET /v1/forms/{id}
Returns a single in-scope form. An out-of-scope or non-existent id returns 404 with a single non-disclosing message (an out-of-scope form is indistinguishable from a missing one).
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The form id (UUID).
Responses
Section titled “ Responses ”The form.
The public projection of a guest-registration form. A curated, additive-only subset.
object
The form’s unique id.
The id of the listing this form belongs to.
The form’s public slug.
The public form status. Additive-only — new values may appear over time. Always handle UNKNOWN as a forward-compatible catch-all for any status this API version does not enumerate.
When the form was created (ISO-8601, UTC). The cursor ordering key.
The API key is missing, malformed, revoked, or expired (UNAUTHENTICATED).
The single error envelope for every public-surface error response.
object
A stable, enumerated error code. Branch on this, never on message.
A human-readable description. May change without a contract break.
A per-response id for support correlation.
Present only for VALIDATION_ERROR — the field-level validation failures.
One field-level validation failure.
object
The rejected field or query parameter name.
What was wrong with it.
The resource does not exist, or the key has no access to it (RESOURCE_NOT_FOUND). The two cases are indistinguishable — no existence disclosure.
The single error envelope for every public-surface error response.
object
A stable, enumerated error code. Branch on this, never on message.
A human-readable description. May change without a contract break.
A per-response id for support correlation.
Present only for VALIDATION_ERROR — the field-level validation failures.
One field-level validation failure.
object
The rejected field or query parameter name.
What was wrong with it.
The per-key rate limit was exceeded (RATE_LIMITED). Retry after the interval in Retry-After.
The single error envelope for every public-surface error response.
object
A stable, enumerated error code. Branch on this, never on message.
A human-readable description. May change without a contract break.
A per-response id for support correlation.
Present only for VALIDATION_ERROR — the field-level validation failures.
One field-level validation failure.
object
The rejected field or query parameter name.
What was wrong with it.
Headers
Section titled “Headers ”Integer seconds to wait before retrying (RFC 7231 delta-seconds form, always >= 1).