Use this endpoint to get the status of a certificate using the certificate's serial number.
curl --request GET 'https://one.digicert.com/iot/api/v1/certificate-status/{{certificate_serial_number}}' \
--header 'x-api-key: {{api_key}}'{
"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"
}{
"errors": [
{
"code": "entity_not_found",
"message": "Certificate with serial number [15905AB23CB34F6263E328C5B0CA2739A23E21] not found"
}
]
}| Name | Req/Opt | Description |
|---|---|---|
| certificate_serial_number | required | The serial number of the certificate to query. |
| 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
|