Certificates Count

Introduction

The Odin Certificate Count API provides the count of certificates that match a specified query. This API allows you to retrieve the number of certificates with a specific issuer common name.

Base URL

The base URL for all API requests is:

The endpoint for host search is:

/certificates/count/

Authentication

All requests to this API must include an authentication token in the headers. Use the following header for authentication:

X-API-Key: V8qb6HJIRKY7tVH0sou90I7YX3pCuqLQfRLmUzxpQbY=

Request Parameters

The API requires the following request parameter to be included in the request body:

To search for certificates count based on specific criteria, send a POST request to the following URL:

https://api.odin.io/v1/certificates/count/

Include the following parameters in the request body:

Example Request

{
    "query": "certificate.issuer.common_name:R3"
}

CURL

{
    curl --location 'https://api.odin.io/v1/certificates/count/' \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --header 'X-API-Key: V8qb6HJIRKY7tVH0sou90I7YX3pCuqLQfRLmUzxpQbY=' \
    --data '{
      "query": "certificate.issuer.common_name:R3"
    }'
}

This cURL command is structured to perform an HTTP POST request to https://api.odin.io/v1/certificates/count/. It includes the following headers:

'Accept: application/json': Specifies that the client expects a JSON response.

'Content-Type: application/json': Indicates that the content in the request body is in JSON format.

'X-API-Key: LlHUAbDjHza+y2ss98eNk1G85n1ctFwWUHX2SEbYZrE=': Provides the API key for authentication with the value 'LlHUAbDjHza+y2ss98eNk1G85n1ctFwWUHX2SEbYZrE='.

data '{ "query": "certificate.issuer.common_name:R3" }': Sends a JSON payload in the request body. The payload specifies a query for counting certificates where the issuer's common name is 'R3'.

Response Parameters

The response from the Odin Certificate Count API will be in JSON format and include the following fields:

Example Response

{
  "success": true,
  "data": {
    "count": 948132656
  }
}