Get a certificate

Retrieve information about a single certificate. A certificate ID is its SHA-256 fingerprint. Use fields to include specific fields in the response. Use exclude_fields to omit specific fields from the response.

In a SOC environment, use this endpoint to look up a certificate by SHA-256 fingerprint to see its subject, issuer, and validity, so you can vet certs seen in TLS logs or alerts.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The SHA-256 certificate fingerprint.

Query Params
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.

string
length ≤ 8192

Comma-separated list of fields to include in the response, in dot notation (for example services.port). Repeated fields are filtered per element. Omit the parameter or pass * to return every field. Unknown fields are rejected.

string
length ≤ 8192

Comma-separated list of fields to exclude from the response, in dot notation (for example services.banner). Repeated fields are filtered per element. Unknown fields are rejected. Cannot be used together with fields.

Headers
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.

string
enum
Defaults to application/vnd.censys.api.v3.certificate.v1+json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/vnd.censys.api.v3.certificate.v1+json
application/problem+json
application/json