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.

Example JSON: Validity

Example of validity as a range with minimum and maximum values

{
  ...
  "validity": {
    "min_duration": {
      "value": 1,
      "unit": "days"
    },
    "max_duration": {
      "value": 10,
      "unit": "years"
    }
  }
}

Example of expiration date validity

{
  ...
  "validity": {
    "expiration_date": {
      "value": "9999-12-31T23:59:59Z"
    }
  }
}

Parameters: Validity

Name

Type

Req/Opt

Description

validity

object

required

Certificate validity details

.. min_duration

object

conditional

Details about minimum certificate validity.

Required in templates that define a validity range.

.. .. value

integer

required

Minimum certificate validity duration.

Possible values: Any positive integer

.. .. unit

string

required

Duration unit for minimum certificate validity.

Possible values:

  • minutes

  • hours

  • days

  • months

  • years

.. max_duration

object

conditional

Details about maximum certificate validity.

Required only in templates that define a validity range.

.. .. value

integer

required

Maximum certificate validity duration.

Possible values: Any positive integer

.. .. unit

string

required

Duration unit for maximum certificate validity.

Possible values:

  • minutes

  • hours

  • days

  • months

  • years

.. expiration_date

object

conditional

Details about certificate validity expiration date.

Required only in templates that define an expiration date validity.

.. .. value

string

required

Date certificate validity ends.

Possible formats:

  • YYYY-MM-DD: With this format, time is always 00:00:00 UTC (for example, 2025-03-24)

  • YYYY-MM-DDTHH:mm:ssZ (for example, 2025-03-24T14:00:00Z)