Certificate

Query certificates with filtering, sorting and pagination

post

Query certificates with filtering, sorting and pagination

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

pageTokenstringOptional

Base64 token for pagination

pageSizeinteger · min: 1 · max: 1000Optional

Number of items to return per page

Default: 100

Responses

200

Success

application/json

nextPageTokenone ofOptional

stringOptional

Token for fetching the next page of results

or

nullOptional

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

post

/certificates/query

HTTPcURLJavaScriptPython

POST /v1/certificates/query HTTP/1.1
Host: api.draftt.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 248

{
  "pageSize": 20,
  "filter": {
    "status": {
      "$eq": "active"
    },
    "expirationDate": {
      "$gte": "2024-12-22T13:47:25.036Z"
    }
  },
  "sort": {
    "expirationDate": "asc"
  },
  "pageToken": "eyJ1bmlxdWVGaWVsZE5hbWUiOiJpZCIsInNvcnQiOnsiZXhwaXJhdGlvbkRhdGUiOnsiZGlyZWN0aW9uIjoiYXNjIn19fQ=="
}

{
  "nextPageToken": "eyJ1bmlxdWVGaWVsZE5hbWUiOiJpZCIsInNvcnQiOnsiZXhwaXJhdGlvbkRhdGUiOnsiZGlyZWN0aW9uIjoiYXNjIn19fQ==",
  "items": [
    {
      "id": "12345",
      "integrationId": "456",
      "uniqueIdentifier": "cert-prod-web-2024",
      "type": "ssl",
      "status": "active",
      "issuer": "Let's Encrypt Authority X3",
      "keyAlgorithm": "RSA",
      "renewalEligibility": "eligible",
      "domainName": "example.com",
      "domains": [
        "example.com",
        "www.example.com",
        "api.example.com"
      ],
      "inUseBy": [
        "web-server-1",
        "load-balancer-2"
      ],
      "created": "2024-01-15T10:30:00.000Z",
      "issuedAt": "2024-01-15T10:30:00.000Z",
      "validityStartDate": "2024-01-15T10:30:00.000Z",
      "expirationDate": "2024-04-15T10:30:00.000Z",
      "dueDate": "2024-03-15T10:30:00.000Z",
      "details": {
        "serialNumber": "03E7B2B58A6E8B9C4D2F1A0E5C7B8D6F",
        "signatureAlgorithm": "SHA256withRSA"
      },
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-02-15T10:30:00.000Z",
      "deletedAt": null,
      "componentIds": [
        789,
        1234
      ],
      "displayType": "SSL Certificate"
    }
  ]
}

Retrieve a specific certificate by ID

get

Get detailed information about a certificate by its unique identifier.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Certificate ID

Example: 123

Responses

200

Certificate details

application/json

idnumberRequired

integrationIdnumberRequired

uniqueIdentifierstringRequired

typestringRequired

statusstringRequired

issuerstringRequired

keyAlgorithmstringOptional

renewalEligibilitystringOptional

domainNamestringRequired

domainsstring[]Optional

inUseBystring[]Optional

createdstring · date-timeOptional

issuedAtstring · date-timeOptional

validityStartDatestring · date-timeOptional

expirationDatestring · date-timeOptional

detailsobjectOptional

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

deletedAtstring · date-timeOptional

componentIdsnumber[]Optional

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Certificate not found

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

get

/certificates/{id}

HTTPcURLJavaScriptPython

GET /v1/certificates/{id} HTTP/1.1
Host: api.draftt.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": 1,
  "integrationId": 123,
  "uniqueIdentifier": "cert-abc123",
  "type": "ssl",
  "status": "active",
  "issuer": "Let's Encrypt Authority X3",
  "keyAlgorithm": "RSA",
  "renewalEligibility": "eligible",
  "domainName": "example.com",
  "domains": [
    "example.com",
    "www.example.com"
  ],
  "inUseBy": [
    "web-server-1",
    "load-balancer-2"
  ],
  "created": "2024-01-15T10:30:00.000Z",
  "issuedAt": "2024-01-15T10:30:00.000Z",
  "validityStartDate": "2024-01-15T10:30:00.000Z",
  "expirationDate": "2024-04-15T10:30:00.000Z",
  "details": {},
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z",
  "componentIds": [
    456,
    789
  ]
}