> For the complete documentation index, see [llms.txt](https://docs.january.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.january.ai/mobile-sdks/readme/error-handling.md).

# Error handling

SDK requests throw `JanuaryError` for local validation, authentication, server responses, networking, timeouts, and decoding failures.

```swift
do {
    let results = try await client.foods.search(
        .init(query: "banana")
    )
    display(results)
} catch let error as JanuaryError {
    switch error.category {
    case .authentication, .authorization:
        requestCredentialRefresh()
    case .validation:
        showInputError(error.message)
    case .rateLimited:
        scheduleRetry(after: error.retryAfterSeconds)
    case .timeout, .transport, .server:
        showRetryState()
    case .notFound:
        showNotFoundState()
    case .decoding:
        reportIntegrationFailure(requestID: error.requestID)
    }
}
```

## Available metadata

| Property            | Description                                         |
| ------------------- | --------------------------------------------------- |
| `category`          | Stable `ErrorCategory` for application control flow |
| `code`              | Machine-readable API error code, when supplied      |
| `message`           | Human-readable failure description                  |
| `httpStatus`        | HTTP status code, when applicable                   |
| `requestID`         | Request identifier for support and diagnostics      |
| `retryAfterSeconds` | Server-provided retry delay, when available         |

Avoid displaying raw server messages without considering the surrounding user experience. Never log credentials, photo contents, nutrition details, or health-profile data while diagnosing an error.