> 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/troubleshooting.md).

# Troubleshooting

## Xcode cannot resolve the package

Confirm that the GitHub account configured in Xcode has access to the private `January-ai/partner-sdk-ios` repository. Then retry package resolution.

## “A development API key is required”

The value passed to `JanuaryPartnerClient(developmentAPIKey:)` is empty or whitespace-only. Check the runtime injection mechanism. Do not replace it with a hard-coded fallback.

## Authentication or authorization errors

Inspect the `JanuaryError` category and HTTP status. Confirm that the development key is active and authorized for the requested Partner API environment.

## Food search validation errors

Name searches require 1–256 characters and a limit from 1–40. Natural-language searches allow up to 512 characters.

## Restaurant validation errors

Check coordinate ranges, radius, and result limit. See [Restaurants](/mobile-sdks/readme/restaurants.md#input-limits).

## Photo scan fails with content too large

Reduce the source image dimensions or JPEG quality before building the data URI. Do not retry the same oversized payload.

## Requests are rate limited

Read `retryAfterSeconds` from `JanuaryError` when available and delay the retry. Avoid tight automatic retry loops.

## Support diagnostics

Capture the failing operation, SDK revision, platform version, `JanuaryError.category`, `code`, `httpStatus`, and `requestID`. Do not include the API key or user health data.