Skip to main content

Validity

The validity allows you to define the certificate validity: as a range with minimal and maximum values or as an expiration date.

JSON structure example

"validity": {
  "min_duration": {
    "value": 1,
    "unit": "days"
  },
  "max_duration": {
    "value": 10,
    "unit": "years"
  }
}
"validity": {
  "expiration_date": {
    "value": "9999-12-31T23:59:59Z"
  }
}

Parameters

Tabella 1. Parameters: Validity

Name

Type

Required/optional

Possible values

min_duration

Object

Required (range validity only)

-

.. value

Integer

Required

Specifies the duration value. Must be a positive integer

.. unit

String

Required

Specifies the duration unit. Supported values include:

  • minutes

  • hours

  • days

  • years

max_duration

Object

Required (range validity only)

-

.. value

Integer

Integer

Specifies the duration value. Must be a positive integer.

.. unit

String

Required

Specifies the duration unit. Supported values include:

  • minutes

  • hours

  • days

  • months

  • years

expiration_date

Object

Required (maximum expiration date validity only)

Specifies the latest date and time at which issued certificates can expire

.. value

String

Required

Specifies the expiration date or date and time. Supported formats include:

  • YYYY-MM-DD: Example: 2025-03-24. Time is automatically set to 00:00:00 UTC

  • YYYY-MM-DDTHH:mm:ssZ: Example: 2025-03-24T14:00:00Z