Checksum endpoint for data downloads

Docs Database Downloads
,
1

Verify the integrity of data downloads with our checksums API endpoint

Checksum verification helps ensure the data download is complete and matches the available data hosted on IPinfo servers.

Checksums support is helpful for our users in the following ways:

  • Verify data integrity and completeness of data downloads.
  • For compliance and security reasons, it is essential to make sure your IPinfo data downloads are not tampered with or corrupted in any way.
  • You can use checksums as an easy verification method to avoid duplicate downloads by comparing the hash values of existing downloads.

The checksum API endpoint

image
image2000×629 93.5 KB

The checksum values are available on our website in the data downloads section and as an API endpoint. The checksum API endpoint:

https://ipinfo.io/data/<data_download_id>/checksums?token=$token

Essentially you have to just add the /checksums sub URL to the API download URL right before the token parameter declaration. You can check out our data downloads filename reference table to check out our API URIs.

The API response output:

{
  "checksums": {
    "md5": "ec1e0b806d09a4d367514fca3d7bae2e",
    "sha1": "488b50ea5c4cb97378bfcaa78b38305def65c65f",
    "sha256": "389294a764a8989d41d74608f1515133f3b910585ad6b75cfe53a81c82f7838f"
  }
}

Comparing checksum values

The checksum API returns hash values in:

  • MD5 (Message Digest Algorithm 5)
  • SHA-1 (Secure Hash Algorithm 1)
  • SHA-256 (Secure Hash Algorithm 256-bit)

checksum_gif

Get checksum hash values

OS Hash type Command
Linux MD5 md5sum filename
Mac MD5 md5 filename
Windows (Powershell) MD5 Get-FileHash -Algorithm MD5 -Path filename
Linux SHA-1 sha1sum filename
Mac SHA-1 shasum -a 1 filename
Windows (Powershell) SHA-1 Get-FileHash -Algorithm SHA1 -Path filename
Linux SHA-256 sha256sum filename
Mac SHA-256 shasum -a 256 filename
Windows (Powershell) SHA-256 Get-FileHash -Algorithm SHA256 -Path filename
3 Likes