Global Data

Retrieve multiple certificates

Changed on Nov 3, 2026

Retrieve information about multiple certificates. You can retrieve up to 1,000 certificates per call. A certificate ID is its SHA-256 fingerprint.<br><br>In a SOC environment, use this endpoint to bulk-check multiple certificates from network telemetry for self-signed, newly issued, or lookalike certs.

post/v3/global/asset/certificate

Request

Base URL
https://api.platform.censys.io
URL
https://api.platform.censys.io/v3/global/asset/certificate
Auth
HTTP bearer

Query parameters

organization_idstring uuid

Example:11111111-2222-3333-4444-555555555555

Headers

X-Organization-IDstring uuid

The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the Getting Started docs for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter.

Example:11111111-2222-3333-4444-555555555555

Request body

certificate_idsstring[] nullable required

A list of SHA-256 certificate fingerprints.

Response

Changes

Nov 3, 2026ec1686b0a36a Revision changes
- breaking
  the /////// response's property format changed from hex to no format for status
- breaking
  the ///// response's property format changed from hex to no format for status
- breaking
  the /////// response's property format changed from hex to no format for status
- breaking
  the ///// response's property format changed from hex to no format for status
- breaking
  the /////// response's property format changed from hex to no format for status
- breaking
  the ///// response's property format changed from hex to no format for status
- breaking
  the /////// response's property format changed from hex to no format for status
- breaking
  the ///// response's property format changed from hex to no format for status

Operation history