Bulk API

The Bulk API exposes a single endpoint, /api/v1/bulk, which can be used to fetch certificates in bulk once their SHA-256 hashes are known. This endpoint is frequently used in conjunction with the Search API Endpoint, which allows you to find the IDs of hosts, websites, and certificates that match a query.

Bulk Certificates

Description

The bulk endpoint returns, in bulk, the current structured data on many specific certificates.

Endpoint

POST /api/v1/bulk/:index

URL Parameters

• index [required string]
  The search index the documents are in. Must be certificates.

Example: /api/v1/bulk/certificates

Data Parameters

• fingerprints: [required string array]
  The SHA-256 fingerprints to be retrieved. This array may contain up to 50 fingerprints.

Example:

{
  "fingerprints": [
    "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
    "48177e03b47bdcb3b6ab28a92f8005b95302418cd5b9ede77a97eb918e4a2da2",
    "d1997c5365c6f2c8205ef8bf1e146dc9ab5bc61e74f3c2dc146e0a509352ea77"
  ]
}

Success Response

200 SUCCESS

The record was successfully retrieved.

Example:

{
  "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50a": {
    "error": "We do not know anything about this certificate.",
    "error_type": "unknown",
    "status": "error"
  },
  "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f": {
    "ct": {
      "google_argon_2020": {
        "added_to_ct_at": "2019-08-21T07:48:45+00:00",
        "ct_to_censys_at": "2019-08-21T07:50:12+00:00",
        "index": 13306056
      },
      "google_pilot": {
        "added_to_ct_at": "2019-08-20T11:23:37+00:00",
        "ct_to_censys_at": "2019-08-20T11:24:52+00:00",
        "index": 724244977
      },
      "google_rocketeer": {
        "added_to_ct_at": "2019-08-20T11:30:29+00:00",
        "ct_to_censys_at": "2019-08-20T11:31:32+00:00",
        "index": 791246196
      }
    },
    "metadata": {
      "added_at": "2019-08-20T11:24:53+00:00",
      "parse_status": "success",
      "parse_version": 0,
      "post_processed": false,
      "seen_in_scan": false,
      "source": "ct",
      "updated_at": "2019-08-21T08:47:53"
    },
    "parent_spki_subject_fingerprint": "a218d43671cc7b1fad349c312cdcbc091b76f967f5682f23c7437caf60511d88",
    "parents": [],
    "parsed": {
      "__expanded_names": [
        "com",
        "azexternalengagement.com",
        "*.azexternalengagement.com"
      ],
      "extensions": {
        "authority_info_access": {
          "issuer_urls": [
            "http://cacerts.thawte.com/ThawteTLSRSACAG1.crt"
          ],
          "ocsp_urls": [
            "http://status.thawte.com"
          ]
        },
        "authority_key_id": "a58cfe32cceb0f2cd419c608b80024885dc3c5b7",
        "basic_constraints": {
          "is_ca": false
        },
        "certificate_policies": [
          {
            "cps": [
              "https://www.digicert.com/CPS"
            ],
            "id": "2.16.840.1.114412.1.1"
          },
          {
            "id": "2.23.140.1.2.2"
          }
        ],
        "crl_distribution_points": [
          "http://cdp.thawte.com/ThawteTLSRSACAG1.crl"
        ],
        "extended_key_usage": {
          "client_auth": true,
          "server_auth": true
        },
        "key_usage": {
          "digital_signature": true,
          "key_encipherment": true,
          "value": 5
        },
        "signed_certificate_timestamps": [
          {
            "log_id": "u9nfvB+KcbWTlCOXqpJ7RzhXlQqrUugakJZkNo4e0YU=",
            "signature": "BAMARzBFAiEAhGkMBT40dCD2cYGdBo0yRu2kVo5IlQ5m0tKhizPRR74CIH8xv4ZlbPQ8Gr61MUo3ogAY7ZwcS+7DzNTOkVqHdy54",
            "timestamp": 1565704658,
            "version": 0
          },
          {
            "log_id": "h3W/51l8+IxDmV+9827/Vo1HVjb/SrVgwbTq/16ggw8=",
            "signature": "BAMARjBEAiBi4R5c+UAxYr9nUrM0iyaobTImuGt4R7UxZ8ZGtCgLIgIgdlU2e6YJGUA3oejSNx5IfMBKr2fETLpIwX5+YgCBo9Q=",
            "timestamp": 1565704658,
            "version": 0
          }
        ],
        "subject_alt_name": {
          "dns_names": [
            "*.azexternalengagement.com",
            "azexternalengagement.com"
          ]
        },
        "subject_key_id": "fa7645d71267094de1cd6c772bc2da290ad94605"
      },
      "fingerprint_md5": "2eeb785490988bef024b36500a0ad43a",
      "fingerprint_sha1": "7815085ecb7609def2c085a28284c2659d176920",
      "fingerprint_sha256": "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
      "issuer": {
        "common_name": [
          "Thawte TLS RSA CA G1"
        ],
        "country": [
          "US"
        ],
        "organization": [
          "DigiCert Inc"
        ],
        "organizational_unit": [
          "www.digicert.com"
        ]
      },
      "issuer_dn": "C=US, O=DigiCert Inc, OU=www.digicert.com, CN=Thawte TLS RSA CA G1",
      "names": [
        "*.azexternalengagement.com",
        "azexternalengagement.com"
      ],
      "redacted": false,
      "serial_number": "3418369420252662180901026495534270441",
      "signature": {
        "self_signed": false,
        "signature_algorithm": {
          "name": "SHA256-RSA",
          "oid": "1.2.840.113549.1.1.11"
        },
        "valid": false,
        "value": "rMTsrhMdNit556apOeJxZVBVbBGy4Rj/wNllOIRlkmov7vEGmN0CFtxQFVccsDyduf3boxXmeZ4l1hkewTQMDx5/4kxelWJukW88fl+ods4JcxYnsdwyvvSfcsOnYgLbuOftbVDJ/CV8G47WlAl+agf56w8OJdmfbunQm4Avx821ZPIghN2fL1CBkUtw/NvtQ671E5R7toX6HVHPeN17yCQfqsRH4TR+fpiXtpOOYPZWtX3lJWiUSNTXwQUkCxxsGfof0MwGk/JsjmoHCLIfnJvprZRlpNw1FLu2RfZHMPMfDP/3JFbR4rcY6wr2/BzRFZJ0R7ePqDoU2NQPZyXxJw=="
      },
      "signature_algorithm": {
        "name": "SHA256-RSA",
        "oid": "1.2.840.113549.1.1.11"
      },
      "spki_subject_fingerprint": "782394d5276dd508bf9514fc9d3d933a5024ff692b82ecb87384d511cbe85c4b",
      "subject": {
        "common_name": [
          "*.azexternalengagement.com"
        ],
        "country": [
          "GB"
        ],
        "locality": [
          "Bollington"
        ],
        "organization": [
          "Amiculum Business Services Limited"
        ],
        "organizational_unit": [
          "Digital"
        ],
        "province": [
          "Cheshire"
        ]
      },
      "subject_dn": "C=GB, ST=Cheshire, L=Bollington, O=Amiculum Business Services Limited, OU=Digital, CN=*.azexternalengagement.com",
      "subject_key_info": {
        "fingerprint_sha256": "2b3b9caf1e273307940bb141c914c156341071ac515d6edb230fc2b27060b95d",
        "key_algorithm": {
          "name": "RSA"
        },
        "rsa_public_key": {
          "exponent": 65537,
          "length": 2048,
          "modulus": "w3p0gI488L2vQJR6dPRWTfokQgLnuurv0yhcGp+TcLIYJo6PzwXlRMdx22mRPEcD1fU6jZlxHG+6jqemx85mZIS/5SVRrPOTzec1hdlHCviBad3cu6OLR6sPU3al70xjF0DOGA77kTEYQVzXzX78eE6jsBqosB7Y7rP0Ifa/HR4BMoFSuuqPgqt0tk3U5DpcQY/9XZxxI0twUDAtjAQg9qTEtE405FSj1CF65h1pq3TRzX3MqkE7YXwrDSjFBjBdg/K0pmvUlMXn0rsipIPyR2Hf5FsYE8ptC459I7Y9jQM2U1ZTADfnmOqHD9gd9TP8kN/rJKK5K8LANeQQN6vI/w=="
        }
      },
      "tbs_fingerprint": "50a1b598914a22518939374879e25ee4510f49883234fc35754476022581d53e",
      "tbs_noct_fingerprint": "cd0f311af2c99cb524cde2d9487da38e25925ff8350610005ddbdcb78614827a",
      "validation_level": "OV",
      "validity": {
        "end": "2020-08-12T12:00:00Z",
        "length": 31579200,
        "start": "2019-08-13T00:00:00Z"
      },
      "version": 3
    },
    "precert": false,
    "raw": "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",
    "tags": [
      "unexpired",
      "leaf",
      "google-ct",
      "ov",
      "trusted",
      "ct"
    ],
    "validation": {
      "apple": {
        "blacklisted": false,
        "had_trusted_path": true,
        "in_revocation_set": false,
        "parents": [
          "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2"
        ],
        "paths": [
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "2d4fad3455ab61397401abbb518922f84336b67e02fc8d2db283825c4ab981bb",
            "9acfab7e43c8d880d06b262a94deeee4b4659989c3d0caf19baf6405e41ab7df"
          ],
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "2d4fad3455ab61397401abbb518922f84336b67e02fc8d2db283825c4ab981bb",
            "d9bc973f88909696da10833197944ca58ac4a88847779c9133374267100eec58",
            "eb04cf5eb1f39afa762f2bb120f296cba520c1b97db1589565b81cb9a17b7244"
          ],
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "aadadd5a879d2eb8c41a89597291292709d42052f5b6399541c694c3b7353cd1",
            "9acfab7e43c8d880d06b262a94deeee4b4659989c3d0caf19baf6405e41ab7df"
          ],
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "aadadd5a879d2eb8c41a89597291292709d42052f5b6399541c694c3b7353cd1",
            "d9bc973f88909696da10833197944ca58ac4a88847779c9133374267100eec58",
            "eb04cf5eb1f39afa762f2bb120f296cba520c1b97db1589565b81cb9a17b7244"
          ],
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "cb3ccbb76031e5e0138f8dd39a23f9de47ffc35e43c1144cea27d46a5ab1cb5f"
          ]
        ],
        "trusted_path": true,
        "type": "leaf",
        "valid": true,
        "was_valid": true,
        "whitelisted": false
      },
      "google_ct_primary": {
        "blacklisted": false,
        "had_trusted_path": true,
        "in_revocation_set": false,
        "parents": [
          "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2"
        ],
        "paths": [
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "cb3ccbb76031e5e0138f8dd39a23f9de47ffc35e43c1144cea27d46a5ab1cb5f"
          ],
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "aadadd5a879d2eb8c41a89597291292709d42052f5b6399541c694c3b7353cd1",
            "9acfab7e43c8d880d06b262a94deeee4b4659989c3d0caf19baf6405e41ab7df"
          ],
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "2d4fad3455ab61397401abbb518922f84336b67e02fc8d2db283825c4ab981bb",
            "9acfab7e43c8d880d06b262a94deeee4b4659989c3d0caf19baf6405e41ab7df"
          ],
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "2d4fad3455ab61397401abbb518922f84336b67e02fc8d2db283825c4ab981bb",
            "d9bc973f88909696da10833197944ca58ac4a88847779c9133374267100eec58",
            "eb04cf5eb1f39afa762f2bb120f296cba520c1b97db1589565b81cb9a17b7244"
          ],
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "aadadd5a879d2eb8c41a89597291292709d42052f5b6399541c694c3b7353cd1",
            "8420dfbe376f414bf4c0a81e6936d24ccc03f304835b86c7a39142fca723a689",
            "a4b6b3996fc2f306b3fd8681bd63413d8c5009cc4fa329c2ccf0e2fa1b140305"
          ]
        ],
        "trusted_path": true,
        "type": "leaf",
        "valid": true,
        "was_valid": true,
        "whitelisted": false
      },
      "microsoft": {
        "blacklisted": false,
        "had_trusted_path": true,
        "in_revocation_set": false,
        "parents": [
          "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2"
        ],
        "paths": [
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "cb3ccbb76031e5e0138f8dd39a23f9de47ffc35e43c1144cea27d46a5ab1cb5f"
          ],
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "aadadd5a879d2eb8c41a89597291292709d42052f5b6399541c694c3b7353cd1",
            "9acfab7e43c8d880d06b262a94deeee4b4659989c3d0caf19baf6405e41ab7df"
          ],
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "2d4fad3455ab61397401abbb518922f84336b67e02fc8d2db283825c4ab981bb",
            "9acfab7e43c8d880d06b262a94deeee4b4659989c3d0caf19baf6405e41ab7df"
          ],
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "aadadd5a879d2eb8c41a89597291292709d42052f5b6399541c694c3b7353cd1",
            "1619e3ec381421b29587a67fa63e06938c191374b30714264659e2c7101aacc5",
            "83ce3c1229688a593d485f81973c0f9195431eda37cc5e36430e79c7a888638b"
          ],
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "2d4fad3455ab61397401abbb518922f84336b67e02fc8d2db283825c4ab981bb",
            "d9bc973f88909696da10833197944ca58ac4a88847779c9133374267100eec58",
            "eb04cf5eb1f39afa762f2bb120f296cba520c1b97db1589565b81cb9a17b7244"
          ]
        ],
        "trusted_path": true,
        "type": "leaf",
        "valid": true,
        "was_valid": true,
        "whitelisted": false
      },
      "nss": {
        "blacklisted": false,
        "had_trusted_path": true,
        "in_revocation_set": false,
        "parents": [
          "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2"
        ],
        "paths": [
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "aadadd5a879d2eb8c41a89597291292709d42052f5b6399541c694c3b7353cd1",
            "d9bc973f88909696da10833197944ca58ac4a88847779c9133374267100eec58",
            "eb04cf5eb1f39afa762f2bb120f296cba520c1b97db1589565b81cb9a17b7244"
          ],
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "aadadd5a879d2eb8c41a89597291292709d42052f5b6399541c694c3b7353cd1",
            "9acfab7e43c8d880d06b262a94deeee4b4659989c3d0caf19baf6405e41ab7df"
          ],
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "2d4fad3455ab61397401abbb518922f84336b67e02fc8d2db283825c4ab981bb",
            "d9bc973f88909696da10833197944ca58ac4a88847779c9133374267100eec58",
            "eb04cf5eb1f39afa762f2bb120f296cba520c1b97db1589565b81cb9a17b7244"
          ],
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "2d4fad3455ab61397401abbb518922f84336b67e02fc8d2db283825c4ab981bb",
            "9acfab7e43c8d880d06b262a94deeee4b4659989c3d0caf19baf6405e41ab7df"
          ],
          [
            "13a88367a15e4e0e9d77158c95e6718d9158ac1bc30619f29ba7bf7d5befc50f",
            "4bcc5e234fe81ede4eaf883aa19c31335b0b26e85e066b9945e4cb6153eb20c2",
            "cb3ccbb76031e5e0138f8dd39a23f9de47ffc35e43c1144cea27d46a5ab1cb5f"
          ]
        ],
        "trusted_path": true,
        "type": "leaf",
        "valid": true,
        "was_valid": true,
        "whitelisted": false
      }
    },
    "zlint": {
      "errors_present": false,
      "fatals_present": false,
      "lints": {
        "n_subject_common_name_included": true
      },
      "notices_present": true,
      "version": 3,
      "warnings_present": false
    }
  }

}

Notes

Each requested certificate will be available as a key in the response, regardless of whether or not we know anything about them. Any certificates which we don't know anything about will be replaced by an error, as shown at the top of the example above.

Error Responses

• 404 NOT FOUND
  The requested record does not exist.
  Example:

  {"error_code":404, "error":"page not found"}

• 429 RATE LIMIT EXCEEDED
  The requested record was not retrieved because you have exceeded your specified rate limit.
  Example:

  {"error_code":429, "error":"rate limit exceeded"}

• 500 INTERNAL SERVER ERROR
  An unexpected error occurred when trying to execute your query. Try again at a later time or contact us at [email protected] if the problem persists.
  Example:

  {"error_code":500, "error":"unknown error occurred"}