External DocumentationTo learn more, visit the Censys documentation.
Parameters
| Parameter | Description |
|---|---|
| Organization ID | The ID of the organization to associate the request with. |
| SHA-256 Fingerprints | A comma-separated list of certificate SHA-256 fingerprints to retrieve information for. |
Example Output
{
"result": [
{
"extensions": {},
"resource": {
"added_at": "string",
"ct": {
"entries": {
"additionalProp": {
"added_to_ct_at": "string",
"ct_to_censys_at": "string",
"index": 0
}
}
},
"ever_seen_in_scan": true,
"fingerprint_md5": "string",
"fingerprint_sha1": "string",
"fingerprint_sha256": "string",
"modified_at": "string",
"names": [
"string"
],
"parent_spki_fingerprint_sha256": "string",
"parent_spki_subject_fingerprint_sha256": "string",
"parse_status": "",
"parsed": {
"extensions": {
"authority_info_access": {
"issuer_urls": [
"string"
],
"ocsp_urls": [
"string"
]
},
"authority_key_id": "string",
"basic_constraints": {
"is_ca": true,
"max_path_len": 0
},
"cabf_organization_id": {
"country": "string",
"reference": "string",
"scheme": "string",
"state": "string"
},
"certificate_policies": [
{
"cps": [
"string"
],
"id": "string",
"user_notice": [
{
"explicit_text": "string",
"notice_reference": {
"notice_numbers": [
0
],
"organization": "string"
}
}
]
}
],
"crl_distribution_points": [
"string"
],
"ct_poison": true,
"extended_key_usage": {
"any": true,
"apple_code_signing": true,
"apple_code_signing_development": true,
"apple_code_signing_third_party": true,
"apple_crypto_development_env": true,
"apple_crypto_env": true,
"apple_crypto_maintenance_env": true,
"apple_crypto_production_env": true,
"apple_crypto_qos": true,
"apple_crypto_test_env": true,
"apple_crypto_tier0_qos": true,
"apple_crypto_tier1_qos": true,
"apple_crypto_tier2_qos": true,
"apple_crypto_tier3_qos": true,
"apple_ichat_encryption": true,
"apple_ichat_signing": true,
"apple_resource_signing": true,
"apple_software_update_signing": true,
"apple_system_identity": true,
"client_auth": true,
"code_signing": true,
"dvcs": true,
"eap_over_lan": true,
"eap_over_ppp": true,
"email_protection": true,
"ipsec_end_system": true,
"ipsec_intermediate_system_usage": true,
"ipsec_tunnel": true,
"ipsec_user": true,
"microsoft_ca_exchange": true,
"microsoft_cert_trust_list_signing": true,
"microsoft_csp_signature": true,
"microsoft_document_signing": true,
"microsoft_drm": true,
"microsoft_drm_individualization": true,
"microsoft_efs_recovery": true,
"microsoft_embedded_nt_crypto": true,
"microsoft_encrypted_file_system": true,
"microsoft_enrollment_agent": true,
"microsoft_kernel_mode_code_signing": true,
"microsoft_key_recovery_21": true,
"microsoft_key_recovery_3": true,
"microsoft_license_server": true,
"microsoft_licenses": true,
"microsoft_lifetime_signing": true,
"microsoft_mobile_device_software": true,
"microsoft_nt5_crypto": true,
"microsoft_oem_whql_crypto": true,
"microsoft_qualified_subordinate": true,
"microsoft_root_list_signer": true,
"microsoft_server_gated_crypto": true,
"microsoft_sgc_serialized": true,
"microsoft_smart_display": true,
"microsoft_smartcard_logon": true,
"microsoft_system_health": true,
"microsoft_system_health_loophole": true,
"microsoft_timestamp_signing": true,
"microsoft_whql_crypto": true,
"netscape_server_gated_crypto": true,
"ocsp_signing": true,
"sbgp_cert_aa_service_auth": true,
"server_auth": true,
"time_stamping": true,
"unknown": [
"string"
]
},
"issuer_alt_name": {
"directory_names": [
{
"common_name": [
"string"
],
"country": [
"string"
],
"domain_component": [
"string"
],
"email_address": [
"string"
],
"given_name": [
"string"
],
"jurisdiction_country": [
"string"
],
"jurisdiction_locality": [
"string"
],
"jurisdiction_province": [
"string"
],
"locality": [
"string"
],
"organization": [
"string"
],
"organization_id": [
"string"
],
"organizational_unit": [
"string"
],
"postal_code": [
"string"
],
"province": [
"string"
],
"serial_number": [
"string"
],
"street_address": [
"string"
],
"surname": [
"string"
]
}
],
"dns_names": [
"string"
],
"edi_party_names": [
{
"name_assigner": "string",
"party_name": "string"
}
],
"email_addresses": [
"string"
],
"ip_addresses": [
"string"
],
"other_names": [
{
"id": "string",
"value": "string"
}
],
"registered_ids": [
"string"
],
"uniform_resource_identifiers": [
"string"
]
},
"key_usage": {
"certificate_sign": true,
"content_commitment": true,
"crl_sign": true,
"data_encipherment": true,
"decipher_only": true,
"digital_signature": true,
"encipher_only": true,
"key_agreement": true,
"key_encipherment": true,
"value": 0
},
"name_constraints": {
"critical": true,
"excluded_directory_names": [
{
"common_name": [
"string"
],
"country": [
"string"
],
"domain_component": [
"string"
],
"email_address": [
"string"
],
"given_name": [
"string"
],
"jurisdiction_country": [
"string"
],
"jurisdiction_locality": [
"string"
],
"jurisdiction_province": [
"string"
],
"locality": [
"string"
],
"organization": [
"string"
],
"organization_id": [
"string"
],
"organizational_unit": [
"string"
],
"postal_code": [
"string"
],
"province": [
"string"
],
"serial_number": [
"string"
],
"street_address": [
"string"
],
"surname": [
"string"
]
}
],
"excluded_edi_party_names": [
{
"name_assigner": "string",
"party_name": "string"
}
],
"excluded_email_addresses": [
"string"
],
"excluded_ip_addresses": [
{
"begin": "string",
"cidr": "string",
"end": "string",
"mask": "string"
}
],
"excluded_names": [
"string"
],
"excluded_registered_ids": [
"string"
],
"excluded_uris": [
"string"
],
"permitted_directory_names": [
{
"common_name": [
"string"
],
"country": [
"string"
],
"domain_component": [
"string"
],
"email_address": [
"string"
],
"given_name": [
"string"
],
"jurisdiction_country": [
"string"
],
"jurisdiction_locality": [
"string"
],
"jurisdiction_province": [
"string"
],
"locality": [
"string"
],
"organization": [
"string"
],
"organization_id": [
"string"
],
"organizational_unit": [
"string"
],
"postal_code": [
"string"
],
"province": [
"string"
],
"serial_number": [
"string"
],
"street_address": [
"string"
],
"surname": [
"string"
]
}
],
"permitted_edi_party_names": [
{
"name_assigner": "string",
"party_name": "string"
}
],
"permitted_email_addresses": [
"string"
],
"permitted_ip_addresses": [
{
"begin": "string",
"cidr": "string",
"end": "string",
"mask": "string"
}
],
"permitted_names": [
"string"
],
"permitted_registered_ids": [
"string"
],
"permitted_uris": [
"string"
]
},
"qc_statements": {
"ids": [
"string"
],
"parsed": {
"etsi_compliance": [
true
],
"legislation": [
{
"country_codes": [
"string"
]
}
],
"limit": [
{
"amount": 0,
"currency": "string",
"currency_number": 0,
"exponent": 0
}
],
"pds_locations": [
{
"language": "string",
"url": "string"
}
],
"retention_period": [
0
],
"sscd": [
true
],
"types": [
{
"ids": [
"string"
]
}
]
}
},
"signed_certificate_timestamps": [
{
"log_id": "string",
"signature": {
"hash_algorithm": "string",
"signature": "string",
"signature_algorithm": "string"
},
"timestamp": "string",
"version": 0
}
],
"subject_alt_name": {
"directory_names": [
{
"common_name": [
"string"
],
"country": [
"string"
],
"domain_component": [
"string"
],
"email_address": [
"string"
],
"given_name": [
"string"
],
"jurisdiction_country": [
"string"
],
"jurisdiction_locality": [
"string"
],
"jurisdiction_province": [
"string"
],
"locality": [
"string"
],
"organization": [
"string"
],
"organization_id": [
"string"
],
"organizational_unit": [
"string"
],
"postal_code": [
"string"
],
"province": [
"string"
],
"serial_number": [
"string"
],
"street_address": [
"string"
],
"surname": [
"string"
]
}
],
"dns_names": [
"string"
],
"edi_party_names": [
{
"name_assigner": "string",
"party_name": "string"
}
],
"email_addresses": [
"string"
],
"ip_addresses": [
"string"
],
"other_names": [
{
"id": "string",
"value": "string"
}
],
"registered_ids": [
"string"
],
"uniform_resource_identifiers": [
"string"
]
},
"subject_key_id": "string",
"tor_service_descriptors": [
{
"algorithm_name": "string",
"hash": "string",
"hash_bits": 0,
"onion": "string"
}
]
},
"issuer": {
"common_name": [
"string"
],
"country": [
"string"
],
"domain_component": [
"string"
],
"email_address": [
"string"
],
"given_name": [
"string"
],
"jurisdiction_country": [
"string"
],
"jurisdiction_locality": [
"string"
],
"jurisdiction_province": [
"string"
],
"locality": [
"string"
],
"organization": [
"string"
],
"organization_id": [
"string"
],
"organizational_unit": [
"string"
],
"postal_code": [
"string"
],
"province": [
"string"
],
"serial_number": [
"string"
],
"street_address": [
"string"
],
"surname": [
"string"
]
},
"issuer_dn": "string",
"ja4x": "string",
"redacted": true,
"serial_number": "string",
"serial_number_hex": "string",
"signature": {
"self_signed": true,
"signature_algorithm": {
"name": "string",
"oid": "string"
},
"valid": true,
"value": "string"
},
"subject": {
"common_name": [
"string"
],
"country": [
"string"
],
"domain_component": [
"string"
],
"email_address": [
"string"
],
"given_name": [
"string"
],
"jurisdiction_country": [
"string"
],
"jurisdiction_locality": [
"string"
],
"jurisdiction_province": [
"string"
],
"locality": [
"string"
],
"organization": [
"string"
],
"organization_id": [
"string"
],
"organizational_unit": [
"string"
],
"postal_code": [
"string"
],
"province": [
"string"
],
"serial_number": [
"string"
],
"street_address": [
"string"
],
"surname": [
"string"
]
},
"subject_dn": "string",
"subject_key_info": {
"dsa": {
"g": "string",
"p": "string",
"q": "string",
"y": "string"
},
"ecdsa": {
"b": "string",
"curve": "string",
"gx": "string",
"gy": "string",
"length": 0,
"n": "string",
"p": "string",
"pub": "string",
"x": "string",
"y": "string"
},
"fingerprint_sha256": "string",
"key_algorithm": {
"name": "string",
"oid": "string"
},
"rsa": {
"exponent": 0,
"length": 0,
"modulus": "string"
},
"unrecognized": {
"raw": "string"
}
},
"unknown_extensions": [
{
"critical": true,
"id": "string",
"value": "string"
}
],
"validity_period": {
"length_seconds": 0,
"not_after": "string",
"not_before": "string"
},
"version": 0
},
"precert": true,
"revocation": {
"crl": {
"next_update": "string",
"reason": "",
"revocation_time": "string",
"revoked": true
},
"ocsp": {
"next_update": "string",
"reason": "",
"revocation_time": "string",
"revoked": true
}
},
"revoked": true,
"spki_fingerprint_sha256": "string",
"spki_subject_fingerprint_sha256": "string",
"tbs_fingerprint_sha256": "string",
"tbs_no_ct_fingerprint_sha256": "string",
"validated_at": "string",
"validation": {
"apple": {
"chains": [
{
"sha256fp": [
"string"
]
}
],
"ever_valid": true,
"had_trusted_path": true,
"has_trusted_path": true,
"in_revocation_set": true,
"is_valid": true,
"parents": [
"string"
],
"type": ""
},
"chrome": {
"chains": [
{
"sha256fp": [
"string"
]
}
],
"ever_valid": true,
"had_trusted_path": true,
"has_trusted_path": true,
"in_revocation_set": true,
"is_valid": true,
"parents": [
"string"
],
"type": ""
},
"microsoft": {
"chains": [
{
"sha256fp": [
"string"
]
}
],
"ever_valid": true,
"had_trusted_path": true,
"has_trusted_path": true,
"in_revocation_set": true,
"is_valid": true,
"parents": [
"string"
],
"type": ""
},
"nss": {
"chains": [
{
"sha256fp": [
"string"
]
}
],
"ever_valid": true,
"had_trusted_path": true,
"has_trusted_path": true,
"in_revocation_set": true,
"is_valid": true,
"parents": [
"string"
],
"type": ""
}
},
"validation_level": "",
"zlint": {
"errors_present": true,
"failed_lints": [
"string"
],
"fatals_present": true,
"notices_present": true,
"timestamp": "string",
"version": 0,
"warnings_present": true
}
}
}
]
}
Workflow Library Example
Get Multiple Certificates with Censys and Send Results Via Email