Certificate status

GET
https://one.digicert.com/iot/api/v1/certificate-status/{{certificate_serial_number}}

Use this endpoint to get the status of a certificate using the certificate's serial number.

Example requests and responses

bash
curl --request GET 'https://one.digicert.com/iot/api/v1/certificate-status/{{certificate_serial_number}}' \
--header 'x-api-key: {{api_key}}'
200 OK
{
    "id": "0341dcf5-9ee8-4736-be34-7b09a4ae43d2",
    "common_name": "enroll-cmpv2",
    "serial_number": "3031D3B7E49697B5BFF95F972E8C917D5A2BDE4D",
    "body": "-----BEGIN CERTIFICATE-----\nMIID5TCCAs2gAwIBAgIUMDHTt+SWl7W/+V+XLoyRfVor3k0wDQYJKoZIhvcNAQEL\nBQAwfzELMAkGA1UEBhMCVUExCzAJBgNVBAgTAk5BMQ0wCwYDVQQHEwRLeWl2MQ0w\nCwYDVQQJEwRLeWl2MQ4wDAYDVQQREwUwMzEyNzEUMBIGA1UEChMLSW9UIENvbXBh\nbnkxHzAdBgNVBAMTFklvVCBDb21wYW55IElzc3VpbmcgQ0EwHhcNMjAxMjAxMDYx\nNDUyWhcNMjEwNjAxMDYxNDUyWjBKMREwDwYDVQQKEwhEaWdpQ2VydDEOMAwGA1UE\nCxMFdW5pdDExDjAMBgNVBAsTBXVuaXQyMRUwEwYDVQQDEwxlbnJvbGwtY21wdjIw\nggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDF1CK02Qyi+4TvJUJZ8BPz\n6kS6F9dTwpV2EdyzOtW9jCNBYHKY1zNsrYhPAraOLFIefiyxegtjFJ+mwrrLjgfG\n4UyYdMW/MzCSithqQ+xXXYpxpqbHFGHFL8DOflVZiR0oh/WyHLG0mjdbQHOl4dbb\nmgRG0k0xX2DNDL0wfX4CL3Aaul2fNCQtqS7n/V1QK4pNxxpxTw5KrXZ5OudouW6a\nJKffnjpSk9dJQSCne3VFm5AqkzYLqvTRucdOxBW54hRP9ZY02/8Yg6MxTH3g99tP\nfidhO6hlA1E6Xiq05EynPUrQkyYwvPI0Ncw3ncbnXv0YbzM7j0uMNSp7b3gxcUqd\nAgMBAAGjgY0wgYowDAYDVR0TAQH/BAIwADAdBgNVHQ4EFgQUcdcYSMK7xEaMsWDk\ncnJWprAjwFswHwYDVR0jBBgwFoAUVCxYCRITRS50x106Wisz9HivLDUwDgYDVR0P\nAQH/BAQDAgTwMCoGA1UdJQEB/wQgMB4GCCsGAQUFBwMCBggrBgEFBQcDAwYIKwYB\nBQUHAwEwDQYJKoZIhvcNAQELBQADggEBAFvzY53Q0C3Z+BSoMyZnaOjTTz+Osgq5\n/uIiCIWsFSMpADv6uI0exNJbTV2B2EJOULrAkNpJGt8p2qXDvr2//NQ9CiQNRlTP\nLuqx8K4ZXtsq+lVM94GaH4x+JYvPbj06tYbBz/T+NJRBO3FS6udrjUD3d3QuzsSa\nAfsZFYLMJpSfF1b/MUYs9HcKpeTIq7LZMwDUKYKsDEjMWSVF21sfAJEmxPfhueyo\nLpJiszelhB9JwiWgbeVvuSUGWimONaB+gNG8a+W0jDzwDb12cbPMoJtQzQekHy6O\nuWGTE85YOiWSAVOAkUpMVIHgupBKsJI8Z4JXJkzjGL03u5dOxAgPkjg=\n-----END CERTIFICATE-----\n",
    "valid_from": "2020-12-01T06:14:52Z",
    "valid_to": "2021-06-01T06:14:52Z",
    "status": "ISSUED"
}
404 Not Found
{
  "errors": [
    {
      "code": "entity_not_found",
      "message": "Certificate with serial number [15905AB23CB34F6263E328C5B0CA2739A23E21] not found"
    }
  ]
}

Path parameters

Name Req/Opt Description
certificate_serial_number required The serial number of the certificate to query.

Response parameters

Name Type Description
id string Certificate ID.
common_name string Certificate common name.
serial_number string Certificate serial number.
body string Certificate body.
valid_from string Date and time when certificate validity starts.
Format: UTC timezone and ISO 8601 date
valid_to string Date and time when certificate validity ends.
Format: UTC timezone and ISO 8601 date
status string Certificate status.
Possible values: ISSUED or REVOKED