- Paging is a cursor. The last issuance’s
idis the next call’safter. Repeat until the answer is an empty array: you have caught up. The operation returns only the array, not the provider’sRetry-Afterheader, so wait a few minutes before asking again with the same cursor (Cert Spotter currently asks firehose readers to wait 5 minutes). - Fields need
expand.dns_names,issuer,revocation,problem_reporting,cert_derand thepubkeyfields are left out unless named inexpand. A nested field takes a dotted path, such asissuer.caa_domains. revokedis three-state. It istrue,false, ornullwhen Cert Spotter cannot determine the status. Expired certificates always reportnull.- Wildcards. A request for
www.example.comdoes not return a*.example.comcertificate unlessmatch_wildcardsis true, and sub-domain certificates needinclude_subdomains. - The firehose needs its own subscription.
firehose.listreturns every issuance across all logs. Falling too far behind answerslagging_client, which means restart from the end rather than retry. - Two failures are not retried.
timeoutmeans the query exceeded your plan’s limit, andpayment_requiredmeans the subscription lapsed. Both need a plan change, not a replay.
- 2 typed API operations
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- API Key (Recommended)
Store the SSLMate Cert Spotter API key before the first call: More: API Key
pnpm corsair setup --plugin=certspotter --tenant=acme api_key=<your-key> (leave out --tenant without multiTenancy), or pass it as key in the plugin options. With Hub, each tenant enters their own key on the connect page. See API key auth.4
Connect a tenant
Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.
Example API calls
List the certificates for a domainWhat’s next
API reference
Every
certspotter.api.* operation with input and output types.Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.