Apple firmware data

Updated

DeviceIdentifier API is able to dynamically download and parse Apple firmware images for analytical purposes. It does not store or archive any Apple binaries. It supports iOS, iPadOS, HomePodOS, tvOS and WatchOS devices.

This functionality has no dependancy on any upstream non-Apple API or tools. As such, in the event of outage or error in the ipsw.me or TSSstatus APIs, or the tsschecker tool, this API will continue to function and receive updates normally.

The API’s firmware data can be used in a number of ways, detailed below.

Fetching data on the latest firmware available (and its signing status) for a given Apple device.

Firmware data for a given device is automatically returned with any internal name query. The nested firmware data is in the following format:

    "firmware": [
        {
            "build": "11D257",
            "filesize": 165768907,
            "ota": true,
            "required_build": "11A465",
            "required_version": "7.0",
            "signed": true,
            "signing_started": "2018-11-01",
            "signing_stopped": null,
            "url": "http://appldnld.apple.com/iOS7.1/031-4897.20140627.JCWhk/d52a3e7a1a2c16c8c400c6829a6d6fe6d5e00760.zip",
            "version": "7.1.2"
        },
        ...
      ]

Fetching data on a particular firmware release

Information on a given firmware release can be requested with the following format of URI:

https://di-api.reincubate.com/v1/firmware/ios/12.4/

{
    "version": "12.4",
    "release_notes": "iOS 12.4 introduces iPhone migration to directly transfer data from an old iPhone to a new iPhone, includes enhancements to Apple News+ and improves the security of your iPhone or iPad. This update:\n\niPhone migration\n\n* Introduces the ability to wirelessly transfer data and migrate directly from an old iPhone to a new iPhone during setup\n\nApple News\n\n* Makes downloaded issues accessible in the My Magazines section, both online and offline\n* Adds all publications in Apple News+, including newspapers, to the catalog at the top of the News+ feed\n* Adds the ability to clear downloaded magazine issues by selecting History > Clear > Clear All\n\nOther improvements and fixes\n\n* Includes a security fix for the Walkie-Talkie app on Apple Watch and re-enables Walkie-Talkie functionality\n\nThis release also includes support for HomePod in Japan and Taiwan.\n\nFor information on the security content of Apple software updates, please visit this website: https://support.apple.com/kb/HT201222", 
    "releases": [
          {
            "build": "16G77", 
            "filesize": 0, 
            "identifier": "iPad11,1", 
            "internal_name": null, 
            "ota": false, 
            "required_build": null, 
            "required_version": null, 
            "sha": "5374906d06c4dcec8f310f97cb1c858f54953993", 
            "signed": true, 
            "signing_started": "2019-07-22", 
            "signing_stopped": null, 
            "url": "http://updates-http.cdn-apple.com/2019SummerFCS/fullrestores/041-86578/9E2214A0-A743-11E9-8F1A-C04349C1A2D4/iPad_Spring_2019_12.4_16G77_Restore.ipsw"
        },
          ...
    ]
}

Fetching a full firmware feed

This archive is designed for use with tsschecker, such that it can be patched into tsschecker.c where the ipsw.me API is unavailable.

It provides a JSON index of available over-the-air (OTA) or non-OTA (full) firmwares available for all devices.

#define FIRMWARE_JSON_URL "https://di-api.reincubate.com/v1/firmware/full-feed/"
#define FIRMWARE_OTA_JSON_URL "https://di-api.reincubate.com/v1/firmware/ota-feed/"

How can we help?

Our support team are here to help!

Our office hours are Monday to Friday, 9 AM to 5 PM GMT. The time is currently 11:26 AM GMT.

We aim to reply to all messages within one working day.

Go to support section › Contact the enterprise team ›
Our awesome support team

Can we improve this article?

We love hearing from users: why not drop us an email, leave a comment, or tweet @reincubate?

© 2008 - 2019 Reincubate Ltd. All rights reserved. Registered in England and Wales #5189175, VAT GB151788978. Reincubate® is a registered trademark. Privacy & terms. We recommend 2FA. Built with in London.