# AppleDB API Usage The AppleDB API is located on api.appledb.dev and hosted from the [`gh-pages`](https://github.com/littlebyteorg/appledb/tree/gh-pages) branch of this repo. All requests should be `GET` requests, this API is currently just static data. URLs are case sensitive. ## Structure > [!NOTE] > See [CALENDARS.md](https://github.com/littlebyteorg/appledb/blob/gh-pages/CALENDARS.md) for calendar endpoint information. - `/bypass/` - jailbreak detection bypasses for apps - [`/bypass/index.json`](https://api.appledb.dev/bypass/index.json) - list all bundle IDs where information is available - `/bypass/.json` ([example](https://api.appledb.dev/bypass/com.freecharge.ios.json)) - information on a specific app's jailbreak detection bypass - [`/bypass/main.json`](https://api.appledb.dev/bypass/main.json) ([`.gz`](https://api.appledb.dev/bypass/main.json.gz)/[`.xz`](https://api.appledb.dev/bypass/main.json.xz)) - contains information for all apps - `/compat/` - jailbreak compatibility information for devices - `/compat//` - compatibility information for a specific device - `/compat//.json` ([example](https://api.appledb.dev/compat/iPhone12,1/19B74.json)) - compatibility information for a specific build and device - `/device/` - information on devices - [`/device/index.json`](https://api.appledb.dev/device/index.json) - list of all keys - `/device/.json` ([example](https://api.appledb.dev/device/Mac14,2.json)) - information on a specific device - [`/device/main.json`](https://api.appledb.dev/device/main.json) ([`.gz`](https://api.appledb.dev/device/main.json.gz)/[`.xz`](https://api.appledb.dev/device/main.json.xz)) - contains information for all devices - `/group/` - information on device groups - [`/group/index.json`](https://api.appledb.dev/group/index.json) - list of all keys - `/group/.json` ([example](https://api.appledb.dev/group/Mac%20Pro%20(2023).json)) - information on a specific device group - [`/group/main.json`](https://api.appledb.dev/group/main.json) ([`.gz`](https://api.appledb.dev/group/main.json.gz)/[`.xz`](https://api.appledb.dev/group/main.json.xz)) - contains information for all device groups - `/ios/` - information on OS versions (not just iOS) - [`/ios/index.json`](https://api.appledb.dev/ios/index.json) - list of all keys (`;`) - `/ios/;.json` ([example](https://api.appledb.dev/ios/iOS;19G71.json)) - information on a specific OS build - [`/ios/main.json`](https://api.appledb.dev/ios/main.json) ([`.gz`](https://api.appledb.dev/ios/main.json.gz)/[`.xz`](https://api.appledb.dev/ios/main.json.xz)) - contains information for all OS builds - `/ios//` - information for a specific OS - `/ios//index.json` ([example](https://api.appledb.dev/ios/macOS/index.json)) - list of all keys for a specific OS, relative to the `/ios/` path - `/ios//main.json` ([example](https://api.appledb.dev/ios/macOS/main.json) ([`.gz`](https://api.appledb.dev/ios/macOS/main.json.gz)/[`.xz`](https://api.appledb.dev/ios/macOS/main.json.xz))) - contains information for all OS builds for a specific OS - Note: `` is the marketing name of the operating system (ie. `Mac OS X`, `OS X`, `macOS`), while `` is an AppleDB-determined name that does not change with marketing changes (ie. `macOS`) - Endpoints using `` may change to using `` in the future - `/jailbreak/` - information on jailbreaks - [`/jailbreak/index.json`](https://api.appledb.dev/jailbreak/index.json) - list of all jailbreaks - `/jailbreak/.json` ([example](https://api.appledb.dev/jailbreak/Dopamine.json)) - information on a specific jailbreak - [`/jailbreak/main.json`](https://api.appledb.dev/jailbreak/main.json) ([`.gz`](https://api.appledb.dev/jailbreak/main.json.gz)/[`.xz`](https://api.appledb.dev/jailbreak/main.json.xz)) - contains information for all jailbreaks - [`/main.json`](https://api.appledb.dev/main.json) ([`.gz`](https://api.appledb.dev/main.json.gz)/[`.xz`](https://api.appledb.dev/main.json.xz)) - contains information for all endpoints, *excluding* jailbreak compatibility information ## API Changelog To stay updated on changes to the API (and AppleDB development in general), you can join our [Discord](https://discord.gg/QBj8pBa). ### 2025-09-16 - Add `signed` to all *OS firmwares that Apple is still signing. This is either an array of devices for which the build is still signed or `true` meaning all devices are signed. Absence of this value means the build is completely unsigned. Note that this uses IPSW build manifests, where available, for iOS, iPadOS, bridgeOS, macOS, and visionOS, and falls back to OTA build manifests in all other cases. ### 2025-09-12 - Add `buildId` and `systemImageId` to *OS firmwares, where applicable. `buildId` mirrors `BuildID` and `systemImageId` mirrors `SystemImageID` from `/System/Library/CoreServices/SystemVersion.plist`. `buildId` is a top level firmware key, while `systemImageId` is per source (as it differs between root FS images). > [!WARNING] > This information is incomplete and still in the process of being added (it is mostly only present for firmwares with unencrypted OTAs, and excludes deltas). Check for key presence before usage. ### 2025-03-12 - Add calendar endpoints ### 2024-03-01 - Remove iosVersion and sortVersion ### 2024-02-01 - Add compressed endpoints for `main.json` > [!IMPORTANT] > With the previous iteration of the API, OTAs were stripped from all endpoints to deal with space issues. With this iteration of the API, OTAs are only stripped from the uncompressed `main.json` endpoints. This is a stopgap until we can figure out how to deal with this issue and make OTAs available on all endpoints. ### 2023-09-13 - Initial version of this document