load-balancer

List load balancer certificate bundles

Returns a list of available certificate bundles.

get/1.3/load-balancer/certificate-bundles

Request

  • Base URL: https://api.upcloud.com
  • URL: https://api.upcloud.com/1.3/load-balancer/certificate-bundles
  • Auth: HTTP bearer

Query parameters

limitinteger

Number of entries to receive at most.

Example:10
offsetinteger

Offset for retrieved results.

labelstring[]

Filter resources by label. Can be provided multiple times for multiple labels. Format: 'key=value' for exact match or 'key' for existence check.

[
  "env=staging"
]

Response

Created

uuidstring uuid required

Unique identifier for the certificate bundle.

namestring required

Human-readable name assigned to the certificate bundle.

tls_type'manual' | 'dynamic' | 'authority' required

The certificate bundle type. Determines how the certificate is provisioned and managed.

operational_state'pending' | 'setup-challenge' | 'complete-challenge' | 'idle' | 'failed-challenge' required

Current operational state of the certificate bundle.

certificatestring byte

PEM-encoded certificate data (base64).

intermediatesstring byte

PEM-encoded intermediate certificates (base64).

hostnamesstring[]

List of hostnames covered by this certificate bundle.

key_type'rsa' | 'ecdsa'

Type of private key used for this certificate bundle.

not_beforestring date-time

The start date and time of certificate validity.

not_afterstring date-time

The expiration date and time of certificate validity.

created_atstring date-time required

Timestamp when this certificate bundle was created.

updated_atstring date-time required

Timestamp when this certificate bundle was last updated.

Example response

[
  {
    "uuid": "8d2f4a1e-0e3f-44a9-a0f5-9b8c84e9c701",
    "name": "mydomain-cert-bundle",
    "tls_type": "dynamic",
    "operational_state": "setup-challenge",
    "hostnames": [
      "example.com",
      "www.example.com"
    ],
    "key_type": "rsa",
    "labels": [],
    "not_before": "2025-11-06T09:00:00.000Z",
    "not_after": "2026-11-06T09:00:00.000Z",
    "created_at": "2025-11-06T09:00:00.000Z",
    "updated_at": "2025-11-06T11:00:00.000Z"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.