Specifications | SSL Certificate Chain Database | WhoisXML API

Specifications

This data feed subscription is licensed to you or your organization only, you may not resell or relicense the data without explicit written permission from Whois API LLC. Any violation will be prosecuted to the fullest extent of the law.

The datasets comes in the following forms

Depending on the subscription plan, you receive different datasets. They contain different data and have different formats. You can find a detailed description of the differences between datasets on the pricing page.

Here are the key details for the different subscription plans:

Lite

  • Data included: only end-user certificates, only validity dates and PEM-encoded raw certificate data.
  • Filename format: ssl.%DATE%.lite.[daily|monthly].data.json
  • Filename example: ssl.2022-02-14.lite.daily.data.json.zip
  • Average file sizes:
File Gzip size Rows
lite.daily.data.json.gz 1.5GiB 22.5M
lite.monthly.data.json.gz 41GiB 285.9M

Basic

  • Data included: complete certificates chain, only validity dates and PEM-encoded raw certificate data.
  • Filename format: ssl.%DATE%.basic.[daily|monthly].data.json
  • Filename example: ssl.2022-02-14.basic.daily.data.json.zip
  • Average file sizes:
File Gzip size Rows
basic.daily.data.json.gz 10GiB 22.5M
basic.monthly.data.json.gz 274GiB 285.9M

Ultimate

  • Data included: complete certificates chain, all supported fields parsed.
  • Filename format: ssl.%DATE%.ultimate.[daily|monthly].data.json
  • Filename example: ssl.2022-02-14.ultimate.daily.data.json.zip
  • Average file sizes:
File Gzip size Rows
ultimate.daily.data.json.gz 15GiB 22.5M
ultimate.monthly.data.json.gz 439GiB 285.9M



How to download the datafeed files

Downloading via HTTPS

Downloading via FTP

Downloading via FTPs

Read more about the FTPS connection: https://en.wikipedia.org/wiki/FTPS.

Our FTP server supports explicit FTP over TLS encryption. You may configure your FTP client to use explicit FTP over TLS encryption for secure communications.

Our FTPS server is accessed using the same paths and API keys as a regular FTP server, the instructions for which are described above. To connect via FTPS, select the "Require explicit FTP over TLS" encryption option in your FTP client, if it supports it. FileZilla configuration example:

explicit FTP over TLS encryption