Skip to content

SSL certificate check API for expiry, issuer and chain

Send a domain. We open a live TLS connection, read the certificate it serves and cross-check certificate transparency logs. You get issuer, validity dates, days remaining, chain status and protocol for 2 credits.

2 creditsEnrichCSV bulkMCP
POST/v1/ssl-certificate-check
{
  "success": true,
  "data": {
    "domain": "example.com",
    "reachable": true,
    "protocol": "TLSv1.3",
    "hostname_match": true,
    "certificate": {
      "subject": {
        "common_name": "example.com"
      },
      "issuer": {
        "common_name": "Example Trust TLS CA 1",
        "organization": "Example Trust Services"
      },
      "sans": [
        "example.com",
        "www.example.com"
      ],
      "serial_number": "04A1B2C3D4E5F60718293A4B5C6D7E8F",
      "signature_algorithm": "ECDSA-SHA384",
      "valid_from": "2026-10-02T00:00:00Z",
      "valid_to": "2026-12-31T23:59:59Z",
      "days_remaining": 42
    },
    "chain": {
      "valid": true,
      "depth": 3,
      "issues": []
    },
    "transparency": {
      "logged": true,
      "first_seen": "2026-10-02T00:14:51Z"
    }
  },
  "meta": {
    "credits_used": 2,
    "credits_remaining": 999,
    "cached": false,
    "request_id": "req_8f3a2c1e9b7d"
  }
}
[01/Response]

What you get back

The fields most teams branch on. The full response is in the sample on this page and in the API reference.

certificate.issuerIssuerThe certificate authority that signed the certificate.
certificate.subjectSubjectThe name the certificate was issued to.
certificate.sansSubject alternative namesEvery hostname the certificate covers, including wildcards.
certificate.valid_toExpiry dateWhen the certificate stops being valid. The start date is in valid_from.
certificate.days_remainingDays remainingWhole days until expiry, ready to compare with an alert threshold.
chain.validChain validityWhether the served chain links to a trusted root without gaps.
hostname_matchHostname matchWhether the domain you asked about is covered by the subject or a SAN.
protocolProtocol versionThe TLS version negotiated in the handshake, such as TLSv1.3.
[02/Capabilities]

What SSL Certificate Check does

01

A live handshake, not a stored record

A new lookup connects to the domain and reads the certificate the server presents at that moment. You see what a browser would see, including a certificate that was replaced an hour ago.

02

Expiry you can alert on

valid_from, valid_to and days_remaining come back as plain values. Schedule a lookup, compare the number with your threshold and open a ticket before the certificate lapses.

03

Chain and hostname checks

The response states whether the chain is complete and trusted, and whether the certificate covers the hostname you sent. Those are the two failures that produce browser warnings while the certificate itself is still in date.

04

Certificate transparency cross-check

Alongside the handshake, the lookup consults public certificate transparency logs. That gives you a second, independent record of the certificate next to what the server presented.

[03/Try it]

See the response before you sign up

Fill in the request and run it. The dashboard has the same form, plus history, bulk upload and live data.

POST /v1/ssl-certificate-check2 credits

Preview mode: this page returns a sample response so you can see the shape of the data. Create a key to run it on live data.

Response

Fill in the field and run the lookup to see what comes back.

[04/Integrate]

One POST request

Send JSON with a Bearer key. The same key works for all 79 products.

curl -X POST https://api.1lookup.dev/v1/ssl-certificate-check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com"}'
Endpoint
POST /v1/ssl-certificate-check
Base URL
https://api.1lookup.dev
Request
domain
Price
2 credits
Coverage
Global
Bulk
CSV upload and bulk API
Cache
Repeats within 7 days are free
Also via
Dashboard and MCP server (run_lookup)
[05/Use cases]

What teams use it for

Monitor your own certificates

Check every production hostname daily with "fresh": true and alert when days_remaining drops below your renewal window.

Audit customer and vendor endpoints

Before you integrate with a third party, confirm its endpoint serves a valid chain on a current TLS version.

Vet unfamiliar websites

A site with a mismatched hostname or a broken chain deserves a closer look. Combine the result with Domain Age when you review a merchant or a link.

Inventory certificates across a portfolio

Upload a CSV of domains and get issuer, SANs and expiry for each one. That is the raw material for a renewal calendar.

The check covers the certificate and handshake on the public internet. It is not a vulnerability scan, and it cannot reach hosts on private networks.

[06/Cost]

2 credits

Credits come with your plan and work on every product. Requests that fail on our side are never charged. Beyond your plan, extra credits are pay as you go.

See pricing
PlanPer 1,000 creditsPer 1,000 lookups
Starter $29/mo$4.83$9.67
Growth $99/mo$3.96$7.92
Pro $299/mo$3.32$6.64
Scale $799/mo$2.66$5.33
[07/FAQ]

SSL Certificate Check questions

What does the SSL certificate check return?

Issuer, subject, subject alternative names, valid-from and valid-to dates, days remaining, chain validity, hostname match and the negotiated protocol version. It also notes whether the certificate appears in certificate transparency logs.

Is the certificate result live or cached?

The first lookup performs a live TLS handshake. The result is then cached for 7 days, so for monitoring you should send "fresh": true to force a new handshake on every run.

What does an SSL certificate check cost?

2 credits per domain. A cached repeat inside 7 days is free, and a forced fresh check counts as a new lookup.

What if the site is down or has no HTTPS?

A handshake needs a server that answers over HTTPS. Hosts that are offline, internal hostnames behind a firewall and sites without HTTPS cannot return a live certificate.

Does a valid certificate mean a site is safe?

No. A certificate shows the connection is encrypted and that whoever requested it controlled the domain. It says nothing about who runs the site or what they do with your data, so treat it as one signal among several.

[ Validate ][ Enrich ]
[Get started]

Run SSL Certificate Check on your own data

Starter is $29 a month for 6,000 credits, enough for 3,000 lookups a month.

[ Screen ][ Scrape ]