Skip to content

Exceptions

pyhellofresh.HelloFreshError

Bases: Exception

Base exception for all HelloFresh library errors.

pyhellofresh.HelloFreshAuthenticationError 

HelloFreshAuthenticationError(
    message: str,
    status_code: int | None = None,
    error_code: str | None = None,
)

Bases: HelloFreshError

Raised when authentication fails, credentials/token missing/expired, or invalid_grant returned.

Source code in src/pyhellofresh/errors.py 
20
21
22
23
24
25
26
27
28
def __init__(
    self,
    message: str,
    status_code: int | None = None,
    error_code: str | None = None,
) -> None:
    super().__init__(message)
    self.status_code = status_code
    self.error_code = error_code

pyhellofresh.HelloFreshResponseError 

HelloFreshResponseError(status_code: int, message: str)

Bases: HelloFreshError

Raised when the API returns an unexpected status code or malformed JSON.

Source code in src/pyhellofresh/errors.py 
34
35
36
37
def __init__(self, status_code: int, message: str) -> None:
    super().__init__(f"API Error [{status_code}]: {message}")
    self.status_code = status_code
    self.message = message

pyhellofresh.HelloFreshConnectionError

Bases: HelloFreshError

Raised on network issues or session timeouts.