Skip to content

Exceptions

property_radar.exceptions

Typed and sanitized exceptions raised by the PropertyRadar client.

PropertyRadarError

Bases: Exception

Base exception for client and API failures.

Parameters:

Name Type Description Default
message str

Sanitized failure description.

required
status_code int | None

HTTP status code, when a response was received.

None
request_id str | None

Vendor request identifier suitable for support correlation.

None
retry_after float | None

Suggested retry delay in seconds, when provided.

None

__init__(message: str, *, status_code: int | None = None, request_id: str | None = None, retry_after: float | None = None) -> None

Initialize sanitized exception metadata.

ConfigurationError

Bases: PropertyRadarError

Raised when client configuration is missing or contradictory.

MutationNotAllowedError

Bases: PropertyRadarError

Raised before a persistent API mutation that was not enabled.

ChargeNotAllowedError

Bases: PropertyRadarError

Raised before a paid API request that was not enabled.

PropertyRadarHTTPError

Bases: PropertyRadarError

Base exception for non-successful HTTP responses.

BadRequestError

Bases: PropertyRadarHTTPError

Raised for HTTP 400 responses.

AuthenticationError

Bases: PropertyRadarHTTPError

Raised for invalid or expired credentials.

PaymentRequiredError

Bases: PropertyRadarHTTPError

Raised when the account balance cannot cover a paid request.

ForbiddenError

Bases: PropertyRadarHTTPError

Raised when valid credentials lack access to an operation.

NotFoundError

Bases: PropertyRadarHTTPError

Raised for missing or account-invisible resources.

ConflictError

Bases: PropertyRadarHTTPError

Raised for HTTP 409 responses.

ValidationError

Bases: PropertyRadarHTTPError

Raised for HTTP 422 responses.

RateLimitError

Bases: PropertyRadarHTTPError

Raised for HTTP 429 responses.

ServerError

Bases: PropertyRadarHTTPError

Raised for HTTP 5xx responses.

NetworkError

Bases: PropertyRadarError

Raised when the request cannot reach the API.

RequestTimeoutError

Bases: NetworkError

Raised when an API request times out.

InvalidResponseError

Bases: PropertyRadarError

Raised when a success response violates the JSON envelope contract.