Security & Trust · DomScan product

SSL Certificates API

Get SSL certificate information including issuer, validity, and security grade.

What you get

Get SSL certificate information including issuer, validity, and security grade.

SynchronousBulkRESTMCPSDKInteractive tool

Choose this product when

Who it is for

Use bounded passive checks to enrich triage and investigation, not to replace authorized testing or human review.

Choose this product when

Choose this to inspect public TLS certificate evidence, validity, names, and chain-related signals where available.

What you get

Get SSL certificate information including issuer, validity, and security grade.

Endpoints

See what each endpoint accepts and returns, its modes and its limits before you integrate.

GET /v1/certificates View API reference
POST /v1/certificates/bulk View API reference
GET /v1/ssl/deep-scan View API referenceRead the guide
GET /v1/ssl/expiring View API referenceRead the guide

Credits and authentication

1-10 Authentication required. See the API reference for the exact cost, including any per-item pricing.

Example operation

Use documented operations to collect, assess, enrich, verify, compare, protect, or monitor public evidence.

GET /v1/certificates Credits: 2

Query parameters

Parameter Type required
domain string required
include_subdomains boolean
Default true
optional
include_expired boolean
Default false
optional
limit integer
Default 100
optional
cursor string optional

Response fields

Field Type
has_more boolean
next_cursor string | null
cache_age_s integer
domain string
certificates[] object[]
certificates[] object
certificates[].id string
certificates[].issuer object
certificates[].common_name string
certificates[].san[] string[]
certificates[].not_before string
certificates[].not_after string
certificates[].is_expired boolean
certificates[].is_wildcard boolean
certificates[].fingerprint_sha256 string
summary object
summary.total_found integer
summary.returned integer
summary.unique_subdomains integer
summary.issuers[] string[]
summary.earliest_cert string | null
summary.latest_cert string | null
pagination object
pagination.limit integer
pagination.offset integer
pagination.returned integer
pagination.total integer
pagination.has_more boolean
pagination.next_cursor string | null
intelligence_summary object
intelligence_summary.data_source string
intelligence_summary.ct_log_sources[] string[]
intelligence_summary.source_count integer
intelligence_summary.cache_status string
intelligence_summary.returned_count integer
intelligence_summary.total_found integer
intelligence_summary.truncated boolean
intelligence_summary.limit integer
intelligence_summary.include_subdomains boolean
intelligence_summary.include_expired boolean
intelligence_summary.unique_name_count integer
intelligence_summary.unique_subdomains integer
intelligence_summary.issuer_count integer
intelligence_summary.wildcard_cert_count integer
intelligence_summary.active_cert_count integer
intelligence_summary.expired_cert_count integer
intelligence_summary.expiring_within_30_days_count integer
intelligence_summary.earliest_cert string | null
intelligence_summary.latest_cert string | null
intelligence_summary.latest_expiry string | null
intelligence_summary.has_more boolean
intelligence_summary.next_cursor string | null
intelligence_summary.warning_code string | null
meta object

Example request

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/certificates?domain=example.com&include_subdomains=true&include_expired=false&limit=25&cursor=example"
const response = await fetch("https://domscan.net/v1/certificates?domain=example.com&include_subdomains=true&include_expired=false&limit=25&cursor=example", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/certificates?domain=example.com&include_subdomains=true&include_expired=false&limit=25&cursor=example",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/certificates?domain=example.com&include_subdomains=true&include_expired=false&limit=25&cursor=example", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/certificates?domain=example.com&include_subdomains=true&include_expired=false&limit=25&cursor=example")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

Example response

{
  "domain": "example.com",
  "certificates": [
    {
      "id": "16234550871",
      "issuer": {
        "name": "R11",
        "organization": "Let's Encrypt"
      },
      "common_name": "www.example.com",
      "san": [
        "example.com",
        "www.example.com"
      ],
      "not_before": "2026-09-14T08:12:44",
      "not_after": "2026-12-13T08:12:43",
      "is_expired": false,
      "is_wildcard": false
    },
    {
      "id": "16198877412",
      "issuer": {
        "name": "R11",
        "organization": "Let's Encrypt"
      },
      "common_name": "api.example.com",
      "san": [
        "api.example.com"
      ],
      "not_before": "2026-08-20T14:03:10",
      "not_after": "2026-11-18T14:03:09",
      "is_expired": false,
      "is_wildcard": false
    }
  ],
  "summary": {
    "total_found": 14,
    "returned": 2,
    "unique_subdomains": 3,
    "issuers": [
      "Let's Encrypt"
    ],
    "earliest_cert": "2026-08-20T14:03:10",
    "latest_cert": "2026-09-14T08:12:44"
  },
  "pagination": {
    "limit": 2,
    "offset": 0,
    "returned": 2,
    "total": 14,
    "has_more": true,
    "next_cursor": "2"
  },
  "intelligence_summary": {
    "data_source": "crt.sh",
    "ct_log_sources": [
      "crt.sh"
    ],
    "source_count": 1,
    "cache_status": "live",
    "returned_count": 2,
    "total_found": 14,
    "truncated": true,
    "limit": 2,
    "include_subdomains": true,
    "include_expired": false,
    "unique_name_count": 3,
    "unique_subdomains": 3,
    "issuer_count": 1,
    "wildcard_cert_count": 0,
    "active_cert_count": 2,
    "expired_cert_count": 0,
    "expiring_within_30_days_count": 0,
    "earliest_cert": "2026-08-20T14:03:10",
    "latest_cert": "2026-09-14T08:12:44",
    "latest_expiry": "2026-12-13T08:12:43",
    "has_more": true,
    "next_cursor": "2",
    "warning_code": null
  },
  "meta": {
    "source": "crt.sh",
    "ct_log_sources": [
      "crt.sh"
    ],
    "query_time_ms": 1240,
    "cached": false,
    "page": {
      "limit": 2,
      "offset": 0,
      "returned": 2,
      "total": 14,
      "has_more": true,
      "next_cursor": "2"
    },
    "served_by": "pop=MAD country=ES"
  }
}

HTTP status codes

  • 200 OK
  • 400 Bad Request
  • 401 Unauthorized
  • 402 Payment Required
  • 429 Too Many Requests
  • 503 Service Unavailable
  • 504 Gateway Timeout

Frequently asked questions

Where can I find the SSL Certificates request and response reference?

Use the API reference for SSL Certificates to review parameters, response fields, examples, status codes, and supported operation modes.

How should I interpret unknown or incomplete results from SSL Certificates?

Unknown or partial means we could not fully confirm the result. Keep the status, confidence, freshness and any limits in mind when you act on it.

How is SSL Certificates priced?

The price depends on the check and the mode you choose. The API reference shows the current credit cost, whether you need an API key, and any per-item pricing.

Used by people at these companies

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse