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.
- 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 SUCCESSThe 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 FOUNDThe requested record does not exist.Example:
{"error_code":404, "error":"page not found"}
- 429 RATE LIMIT EXCEEDEDThe requested record was not retrieved because you have exceeded your specified rate limit.Example:
{"error_code":429, "error":"rate limit exceeded"}
- 500 INTERNAL SERVER ERRORAn 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"}