--- updatedAt: 2026-03-01T17:32:13.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/mtls-origin-keystore/llms.txt --- # List client certificate versions Versions of the client certificate specified by `certificateId`. # OpenAPI definition ```json { "externalDocs": { "description": "See documentation for Akamai's mTLS Origin Keystore API", "url": "https://techdocs.akamai.com/mtls-origin-keystore/reference" }, "info": { "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "title": "Client certificate versions", "version": "v1" }, "openapi": "3.0.0", "paths": { "/client-certificates/{certificateId}/versions": { "get": { "description": "Versions of the client certificate specified by `certificateId`.", "externalDocs": { "description": "See documentation for this operation in Akamai's mTLS Origin Keystore API", "url": "https://techdocs.akamai.com/mtls-origin-keystore/reference/get-client-cert-versions" }, "operationId": "get-client-cert-versions", "parameters": [ { "description": "Set to `true` to include properties using this certificate version. Default is `false`.", "in": "query", "name": "includeAssociatedProperties", "required": false, "schema": { "default": false, "example": true, "type": "boolean" }, "x-akamai": { "file-path": "parameters/include-properties-query.yaml" } }, { "description": "For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).", "in": "query", "name": "accountSwitchKey", "required": false, "schema": { "example": "1-5C0YLB:1-8BYUX", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "examples": { "akamai-signed": { "summary": "Akamai-signed client certificate version", "value": { "versions": [ { "certificateBlock": { "certificate": "-----BEGIN CERTIFICATE-----\nMIID7DCCAtSgAwIBAgIIU/+HoR4hR1B\n-----END CERTIFICATE-----", "keyAlgorithm": "RSA", "trustChain": "-----BEGIN CERTIFICATE-----\nMIIDrDCCApSgAwIBAgIUeFT9PKkMR4FanMM2MePtOp+iWNtswK0Zu7H\ng9pOu5jBbWZFmTl2SMyO9PotrIDo7b7KR1DDEkYCQfY=\n-----END CERTIFICATE-----" }, "createdBy": "jdupont", "createdDate": "2024-05-06T21:27:13Z", "expiryDate": "2024-08-06T21:27:16Z", "issuedDate": "2024-05-06T21:27:16Z", "issuer": "1360 Account CA G332", "keyAlgorithm": "RSA", "keySizeInBytes": "2048", "signatureAlgorithm": "SHA256_WITH_RSA", "status": "DEPLOYMENT_PENDING", "subject": "/C=US/O=Akamai Technologies/OU=KMI/CN=/", "validation": { "errors": [], "warnings": [] }, "version": 3, "versionAlias": "CURRENT", "versionGuid": "13d16e57-22fa-4475-af0a-b2b745115128" }, { "certificateBlock": { "certificate": "-----BEGIN CERTIFICATE-----\nMIIDoDCCAoigAwIBAgIJAOtdmivS7ORRMA0GCSqGSIb3DQEBCwUAnqkg=\n-----END CERTIFICATE-----", "keyAlgorithm": "RSA", "trustChain": "-----BEGIN CERTIFICATE-----\nMIIDrDCCApSgAwIBAgIUeFT9PKkMR4FanMM2MePtOp1X+iWNtswK0Zu7H\ng9pOu5jBbWZFmTl2SMyO9PotrIDo7b7KR1DDEkYCQfY=\n-----END CERTIFICATE-----" }, "createdBy": "mrossi", "createdDate": "2024-03-04T12:21:42Z", "ellipticCurve": "secp256r1", "expiryDate": "2024-06-04T12:21:43Z", "issuedDate": "2024-03-04T12:21:43Z", "issuer": "1360 Account CA G172", "keyAlgorithm": "ECDSA", "signatureAlgorithm": "SHA256_WITH_RSA", "status": "DEPLOYED", "subject": "/C=US/O=Akamai Technologies, Inc./OU=1360 1-3CV382 18385 Delivery EnhancedTLS-Core/CN=/", "validation": { "errors": [], "warnings": [] }, "version": 2, "versionAlias": "PREVIOUS", "versionGuid": "b488bcc4-67de-35d2-aa65-f040ef1bf893" } ] } }, "third-party-signed": { "summary": "Third-party-signed client certificate version", "value": { "versions": [ { "certificateBlock": { "certificate": "-----BEGIN CERTIFICATE-----\nMIIDvzCCAqegAwIBAgIUSHKSiEezbxkLjktO\nq17v\n-----END CERTIFICATE-----", "keyAlgorithm": "RSA" }, "certificateSubmittedBy": "ccare2", "certificateSubmittedDate": "2025-06-23T14:50:38Z", "createdBy": "adevi", "createdDate": "2025-06-23T14:46:42Z", "csrBlock": { "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICrDCCAZQCAQAwZzEL==\n-----END CERTIFICATE REQUEST-----", "keyAlgorithm": "RSA" }, "expiryDate": "2025-07-23T14:50:23Z", "issuedDate": "2025-06-23T14:50:23Z", "keyAlgorithm": "RSA", "keySizeInBytes": "2048", "signatureAlgorithm": "SHA256_WITH_RSA", "status": "DEPLOYED", "subject": "/CN=test-june56/OU=2437 G-37F31GV 176038/O=Akamai Technologies, Inc./C=US/", "validation": { "errors": [], "warnings": [] }, "version": 5, "versionAlias": "PREVIOUS", "versionGuid": "accd5d5a-3909-3a52-b24e-78053b6d01a5" }, { "certificateBlock": { "certificate": "-----BEGIN CERTIFICATE-----\nMIIDvzCCAqeZv/NJCh233FXCfcrMbqipXYeMpnTrtO\nq17v\n-----END CERTIFICATE-----", "keyAlgorithm": "RSA" }, "certificateSubmittedBy": "ccare2", "certificateSubmittedDate": "2025-06-23T14:50:38Z", "createdBy": "afero", "createdDate": "2025-06-23T14:46:42Z", "csrBlock": { "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICrDCCAZQCAQAwZzELMAkGkeg==\n-----END CERTIFICATE REQUEST-----", "keyAlgorithm": "RSA" }, "expiryDate": "2025-07-23T14:50:23Z", "issuedDate": "2025-06-23T14:50:23Z", "keyAlgorithm": "RSA", "keySizeInBytes": "2048", "signatureAlgorithm": "SHA256_WITH_RSA", "status": "DEPLOYED", "subject": "/CN=test-june56/OU=2437 G-37F31GV 176038/O=Akamai Technologies, Inc./C=US/", "validation": { "errors": [], "warnings": [] }, "version": 5, "versionGuid": "a20ce6e9-2828-3a7f-bf69-a630a58bda56" }, { "certificateBlock": { "certificate": "-----BEGIN CERTIFICATE-----\nMIIDvzCCAqsDA0Y\nfNBt\n-----END CERTIFICATE-----", "keyAlgorithm": "RSA" }, "certificateSubmittedBy": "ccare2", "certificateSubmittedDate": "2025-06-23T14:49:50Z", "createdBy": "jperez", "createdDate": "2025-06-23T14:46:34Z", "csrBlock": { "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICrDCCAZIrkun9UhWikZ+425bw==\n-----END CERTIFICATE REQUEST-----", "keyAlgorithm": "RSA" }, "expiryDate": "2025-07-23T14:49:33Z", "issuedDate": "2025-06-23T14:49:33Z", "keyAlgorithm": "RSA", "keySizeInBytes": "2048", "signatureAlgorithm": "SHA256_WITH_RSA", "status": "DEPLOYED", "subject": "/CN=test-june56/OU=2437 G-37F31GV 176038/O=Akamai Technologies, Inc./C=US/", "validation": { "errors": [], "warnings": [] }, "version": 3, "versionGuid": "0170496a-c4aa-30be-b5ce-cfe7d7af39a6" }, { "certificateBlock": { "certificate": "-----BEGIN CERTIFICATE-----\nMIIDvzCCAUO\n-----END CERTIFICATE-----", "keyAlgorithm": "RSA" }, "certificateSubmittedBy": "ccare2", "certificateSubmittedDate": "2025-06-23T14:55:11Z", "createdBy": "jperez", "createdDate": "2025-06-23T14:46:29Z", "csrBlock": { "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICFO26Y35EXlMZ\nXSW9eYqf7iKQmqPTr7dcmw==\n-----END CERTIFICATE REQUEST-----", "keyAlgorithm": "RSA" }, "expiryDate": "2025-07-23T14:54:53Z", "issuedDate": "2025-06-23T14:54:53Z", "keyAlgorithm": "RSA", "keySizeInBytes": "2048", "signatureAlgorithm": "SHA256_WITH_RSA", "status": "DEPLOYED", "subject": "/CN=test-june56/OU=2437 G-37F31GV 176038/O=Akamai Technologies, Inc./C=US/", "validation": { "errors": [], "warnings": [] }, "version": 2, "versionAlias": "CURRENT", "versionGuid": "8c1011eb-20a5-37fd-acb7-0c2a30d11a0f" }, { "certificateBlock": { "certificate": "-----BEGIN CERTIFICATE-----\nMIIDvzCCAqegAwIBAgUO\n-----END CERTIFICATE-----", "keyAlgorithm": "RSA" }, "certificateSubmittedBy": "ccare2", "certificateSubmittedDate": "2025-06-23T14:55:11Z", "createdBy": "afero", "createdDate": "2025-06-23T14:46:29Z", "csrBlock": { "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICrDCCAZQC3VydZBO\nA6/6CR6x4iBaoJn+OirVteZFwEX5J/VbMwQTBvLMLrub9+/tW4IpFO26Y35EXlMZ\nXSW9eYqf7iKQmqPTr7dcmw==\n-----END CERTIFICATE REQUEST-----", "keyAlgorithm": "RSA" }, "expiryDate": "2025-07-23T14:54:53Z", "issuedDate": "2025-06-23T14:54:53Z", "keyAlgorithm": "RSA", "keySizeInBytes": "2048", "signatureAlgorithm": "SHA256_WITH_RSA", "status": "DEPLOYED", "subject": "/CN=test-june56/OU=2437 G-37F31GV 176038/O=Akamai Technologies, Inc./C=US/", "validation": { "errors": [], "warnings": [] }, "version": 2, "versionGuid": "f10241c0-7cb7-3d5a-923b-43a5fce0d02e" } ] } } }, "schema": { "additionalProperties": false, "description": "Schema for a list of client certificate versions under the account.", "properties": { "versions": { "description": "The client certificate versions.", "items": { "additionalProperties": false, "description": "Schema for a client certificate version.", "properties": { "certificateBlock": { "additionalProperties": false, "description": "Contains the client certificate data for a THIRD_PARTY/AKAMAI signed certificate, including its PEM-encoded value and the selected encryption algorithm. Optionally includes a trust chain. It appears as null if not specified.", "nullable": true, "properties": { "certificate": { "description": "A text representation of the client certificate in PEM format.", "minLength": 1, "type": "string" }, "keyAlgorithm": { "description": "Identifies the client certificate's encryption algorithm, either `RSA` or `ECDSA`.", "enum": [ "RSA", "ECDSA" ], "minLength": 1, "type": "string" }, "trustChain": { "description": "A text representation of the trust chain in PEM format.", "minLength": 1, "type": "string" } }, "required": [ "certificate", "keyAlgorithm" ], "type": "object", "x-akamai": { "file-path": "schemas/certificate-block.yaml" } }, "certificateSubmittedBy": { "description": "The user who uploaded the `THIRD_PARTY` client certificate version. Appears as `null` if not specified.", "minLength": 1, "nullable": true, "type": "string" }, "certificateSubmittedDate": { "description": "__Read-only__ An ISO 8601 timestamp indicating when the `THIRD_PARTY` signer client certificate version was upload. Appears as `null` if not specified.", "format": "date-time", "nullable": true, "readOnly": true, "type": "string" }, "createdBy": { "description": "The user who created the client certificate version.", "minLength": 1, "type": "string" }, "createdDate": { "description": "__Read-only__ An ISO 8601 timestamp indicating the client certificate's creation.", "format": "date-time", "readOnly": true, "type": "string" }, "csrBlock": { "additionalProperties": false, "description": "Creates a Certificate Signing Request (CSR) for new `THIRD_PARTY` client certificates as the signer. The CSR encapsulates all necessary information the Certificate Authority (CA) needs to issue your certificate. Appears as `null` if not specified.", "nullable": true, "properties": { "csr": { "description": "Text of the certificate signing request.", "minLength": 1, "type": "string" }, "keyAlgorithm": { "description": "Identifies the client certificate's encryption algorithm, either `RSA` or `ECDSA`.", "enum": [ "RSA", "ECDSA" ], "minLength": 1, "type": "string" } }, "required": [ "csr", "keyAlgorithm" ], "type": "object", "x-akamai": { "file-path": "schemas/csr-block.yaml" } }, "deleteRequestedDate": { "description": "__Read-only__ An ISO 8601 timestamp indicating the client certificate version's deletion request. Appears as `null` if there's no request.", "format": "date-time", "nullable": true, "readOnly": true, "type": "string" }, "deployedDate": { "description": "__Read-only__ An ISO 8601 timestamp indicating the client certificate version's activation. Appears as `null` if not specified.", "format": "date-time", "nullable": true, "readOnly": true, "type": "string" }, "ellipticCurve": { "description": "Specifies the key elliptic curve when key algorithm `ECDSA` is used.", "type": "string" }, "expiryDate": { "description": "__Read-only__ An ISO 8601 timestamp indicating when the client certificate version expires.", "format": "date-time", "readOnly": true, "type": "string" }, "issuedDate": { "description": "__Read-only__ An ISO 8601 timestamp indicating the client certificate version's availability.", "format": "date-time", "readOnly": true, "type": "string" }, "issuer": { "description": "The signing entity of the AKAMAI signed client certificate version.", "minLength": 1, "nullable": true, "type": "string" }, "keyAlgorithm": { "description": "Identifies the client certificate version's encryption algorithm. Supported values are `RSA` and `ECDSA`.", "enum": [ "RSA", "ECDSA" ], "minLength": 1, "type": "string" }, "keySizeInBytes": { "description": "The private key length of the client certificate version when key algorithm `RSA` is used.", "minLength": 1, "type": "string" }, "properties": { "description": "Properties that use the client certificate version for mTLS authentication.", "items": { "additionalProperties": false, "description": "Details of a property that uses the client certificate version.", "properties": { "assetId": { "description": "An alternative identifier for the property. Use this value to key the property in the Identity and Access Management API. See [Manage properties and includes](https://techdocs.akamai.com/iam-api/reference/manage-access-to-properties-and-includes).", "minimum": 1, "type": "integer" }, "groupId": { "description": "Identifies the group to which the property is assigned. See [ID prefixes](https://techdocs.akamai.com/cp-codes/reference/id-prefixes) for guidance on comparing this value with data from PAPI.", "minimum": 1, "type": "integer" }, "propertyName": { "description": "A unique, descriptive name for the property.", "minLength": 1, "type": "string" }, "propertyVersion": { "description": "The property's version.", "minimum": 1, "type": "integer" } }, "required": [ "propertyName", "propertyVersion", "assetId", "groupId" ], "type": "object", "x-akamai": { "file-path": "schemas/property.yaml" } }, "minItems": 0, "type": "array" }, "scheduledDeleteDate": { "description": "__Read-only__ An ISO 8601 timestamp indicating client certificate version's deletion. Appears as `null` if there's no request. ", "format": "date-time", "nullable": true, "readOnly": true, "type": "string" }, "signatureAlgorithm": { "description": "Specifies the algorithm that secures the data exchange between the edge server and origin.", "minLength": 1, "type": "string" }, "status": { "description": "The client certificate version status. Either `AWAITING_SIGNED_CERTIFICATE`, `DEPLOYMENT_PENDING`, `DEPLOYED`, or `DELETE_PENDING`. [Learn more](https://techdocs.akamai.com/mtls-origin-keystore/docs/view-cert-versions). ", "enum": [ "AWAITING_SIGNED_CERTIFICATE", "DEPLOYMENT_PENDING", "DEPLOYED", "DELETE_PENDING" ], "type": "string" }, "subject": { "description": "The public key's entity stored in the client certificate version's subject public key field. [Learn more](https://techdocs.akamai.com/mtls-origin-keystore/docs/view-cert-versions).", "minLength": 1, "type": "string" }, "validation": { "additionalProperties": false, "description": "Checks the versions when uploading `THIRD_PARTY` signed client certificates to [Mutual TLS Origin Keystore](https://techdocs.akamai.com/mtls-origin-keystore/docs/welcome). ", "properties": { "errors": { "description": "Indicates validation errors you need to resolve for the request to succeed.", "items": { "additionalProperties": false, "description": "Validation result specifying the type, message, and reason for the error or warning.", "properties": { "message": { "description": "Specifies the error or warning details.", "minLength": 1, "type": "string" }, "reason": { "description": "Specifies the error or warning root cause.", "minLength": 1, "type": "string" }, "type": { "description": "Specifies the error or warning category.", "minLength": 1, "type": "string" } }, "required": [ "type", "message", "reason" ], "type": "object", "x-akamai": { "file-path": "schemas/version-validation-result.yaml" } }, "minItems": 0, "type": "array" }, "warnings": { "description": "Indicates validation warnings you can resolve. For example, your uploaded client certificate is issued on a future date.", "items": { "additionalProperties": false, "description": "Validation result specifying the type, message, and reason for the error or warning.", "properties": { "message": { "description": "Specifies the error or warning details.", "minLength": 1, "type": "string" }, "reason": { "description": "Specifies the error or warning root cause.", "minLength": 1, "type": "string" }, "type": { "description": "Specifies the error or warning category.", "minLength": 1, "type": "string" } }, "required": [ "type", "message", "reason" ], "type": "object", "x-akamai": { "file-path": "schemas/version-validation-result.yaml" } }, "minItems": 0, "type": "array" } }, "required": [ "errors", "warnings" ], "title": "Validation results", "type": "object", "x-akamai": { "file-path": "schemas/version-validation.yaml" } }, "version": { "description": "The unique identifier for the certificate version.", "minimum": 0, "type": "integer" }, "versionAlias": { "description": "An alias assigned to the client certificate version, used for identification within Property Manager. For third-party client certificates, only the two most recent uploaded versions are automatically labeled as `CURRENT` and `PREVIOUS`.", "enum": [ "CURRENT", "PREVIOUS" ], "nullable": true, "type": "string" }, "versionGuid": { "description": "The unique identifier for the client certificate version. Use it to configure mutual authentication (mTLS) sessions between the origin and edge servers in Property Manager's Mutual TLS Origin Keystore behavior.", "type": "string" } }, "required": [ "version", "versionGuid", "status", "createdBy", "createdDate", "validation" ], "title": "Client Certificate Version", "type": "object", "x-akamai": { "file-path": "schemas/client-cert-version.v1.yaml" } }, "minItems": 0, "type": "array" } }, "required": [ "versions" ], "title": "List client certificate versions under the account", "type": "object", "x-akamai": { "file-path": "schemas/client-cert-versions.v1.yaml" } } } }, "description": "The response returns the versions of the client certificate.", "headers": { "X-RateLimit-Limit": { "description": "Indicates how many total requests you are allowed to make in the current time window. You can't make more requests than this value. See [Rate Limiting](https://techdocs.akamai.com/mtls-origin-keystore/reference/rate-resource-limit).", "schema": { "example": 20, "type": "integer" }, "x-akamai": { "file-path": "headers/ratelimit-limit-header.v1.yaml" } }, "X-RateLimit-Next": { "description": "Indicates the time when you can make the next request after exhausting the allowed limit in the current time period. See [Rate Limiting](https://techdocs.akamai.com/mtls-origin-keystore/reference/rate-resource-limit).", "schema": { "example": "2023-11-08T05:54:01Z", "type": "string" }, "x-akamai": { "file-path": "headers/ratelimit-limit-next.v1.yaml" } }, "X-RateLimit-Remaining": { "description": "Indicates how many remaining requests you can make in the current time window. See [Rate Limiting](https://techdocs.akamai.com/mtls-origin-keystore/reference/rate-resource-limit).", "schema": { "example": 17, "type": "integer" }, "x-akamai": { "file-path": "headers/ratelimit-remaining-header.v1.yaml" } } } }, "400": { "content": { "application/problem+json": { "examples": { "invalid-certificate": { "summary": "Invalid certificate or trust chain", "value": { "detail": "Bad Request", "errors": [ { "detail": "Certificate is either invalid or cannot not be accepted.", "field": "certificate", "problemId": "f1658521-6e7d-4051-89e6-5dce765029af", "title": "Invalid Input", "type": "error-types/invalid" } ], "instance": "7cc378a1-ba9e-41a6-8255-27ee0a5a3897", "problemId": "7cc378a1-ba9e-41a6-8255-27ee0a5a3897", "status": 400, "title": "Bad Request", "type": "bad-request" } }, "invalid-query-param": { "summary": "Duplicate certificate name", "value": { "detail": "Bad Request", "errors": [ { "detail": "Certificate with same name already exists.", "field": "certificateName", "problemId": "00c4e7b5-dc7b-43f9-9f18-de8de3c82527", "title": "Invalid Input", "type": "error-types/invalid" } ], "instance": "/f311c60f-9914-4e23-be2c-db8dbb711a8a", "status": 400, "title": "Bad Request", "type": "bad-request" } } }, "schema": { "additionalProperties": true, "description": "Schema for a problem.", "properties": { "detail": { "description": "__Read-only__ Explains the problem with any guidance on how to fix it.", "minLength": 1, "readOnly": true, "type": "string" }, "errors": { "description": "__Read-only__ The problem type errors.", "items": { "description": "A further nested HTTP problem object that describes individual errors.", "type": "object", "x-akamai": { "file-path": "schemas/http-problem-nested.yaml" } }, "minItems": 1, "readOnly": true, "type": "array" }, "instance": { "description": "__Read-only__ Non-navigable URI that identifies each occurrence of the problem.", "minLength": 1, "readOnly": true, "type": "string" }, "status": { "description": "__Read-only__ The HTTP status code.", "minimum": 1, "readOnly": true, "type": "integer" }, "title": { "description": "__Read-only__ Human readable summary of each error case.", "minLength": 1, "readOnly": true, "type": "string" }, "type": { "description": "__Read-only__ Non-navigable URI that identifies each error case.", "minLength": 1, "readOnly": true, "type": "string" } }, "required": [ "type" ], "title": "Generic problem", "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Bad request](https://techdocs.akamai.com/mtls-origin-keystore/reference/400).", "x-akamai": { "file-path": "errors/400.yaml" } }, "401": { "content": { "application/problem+json": { "example": { "clientIp": "192.0.2.157", "detail": "The signature does not match", "instance": "https://akaa-6wlzy25uej7weyeq-sjimhdwjhb2rgohw.luna-dev.akamaiapis.net/mtls-origin-keystore/v1/client-certificates", "method": "POST", "requestId": "9452eed", "requestTime": "2024-05-16T11:24:48Z", "serverIp": "192.0.2.112", "status": 401, "title": "Not authorized", "type": "https://problems.luna-dev.akamaiapis.net/-/pep-authn/deny" }, "schema": { "additionalProperties": true, "description": "Schema for a problem.", "properties": { "detail": { "description": "__Read-only__ Explains the problem with any guidance on how to fix it.", "minLength": 1, "readOnly": true, "type": "string" }, "errors": { "description": "__Read-only__ The problem type errors.", "items": { "description": "A further nested HTTP problem object that describes individual errors.", "type": "object", "x-akamai": { "file-path": "schemas/http-problem-nested.yaml" } }, "minItems": 1, "readOnly": true, "type": "array" }, "instance": { "description": "__Read-only__ Non-navigable URI that identifies each occurrence of the problem.", "minLength": 1, "readOnly": true, "type": "string" }, "status": { "description": "__Read-only__ The HTTP status code.", "minimum": 1, "readOnly": true, "type": "integer" }, "title": { "description": "__Read-only__ Human readable summary of each error case.", "minLength": 1, "readOnly": true, "type": "string" }, "type": { "description": "__Read-only__ Non-navigable URI that identifies each error case.", "minLength": 1, "readOnly": true, "type": "string" } }, "required": [ "type" ], "title": "Generic problem", "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Unauthorized](https://techdocs.akamai.com/mtls-origin-keystore/reference/401).", "x-akamai": { "file-path": "errors/401.yaml" } }, "403": { "content": { "application/problem+json": { "example": { "detail": "You are not authorized to perform this action. Please contact Akamai support team to get this resolved.", "status": 403, "title": "Forbidden.", "type": "/mtls-origin-keystore/error-types/forbidden" }, "schema": { "additionalProperties": true, "description": "Schema for a problem.", "properties": { "detail": { "description": "__Read-only__ Explains the problem with any guidance on how to fix it.", "minLength": 1, "readOnly": true, "type": "string" }, "errors": { "description": "__Read-only__ The problem type errors.", "items": { "description": "A further nested HTTP problem object that describes individual errors.", "type": "object", "x-akamai": { "file-path": "schemas/http-problem-nested.yaml" } }, "minItems": 1, "readOnly": true, "type": "array" }, "instance": { "description": "__Read-only__ Non-navigable URI that identifies each occurrence of the problem.", "minLength": 1, "readOnly": true, "type": "string" }, "status": { "description": "__Read-only__ The HTTP status code.", "minimum": 1, "readOnly": true, "type": "integer" }, "title": { "description": "__Read-only__ Human readable summary of each error case.", "minLength": 1, "readOnly": true, "type": "string" }, "type": { "description": "__Read-only__ Non-navigable URI that identifies each error case.", "minLength": 1, "readOnly": true, "type": "string" } }, "required": [ "type" ], "title": "Generic problem", "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Forbidden](https://techdocs.akamai.com/mtls-origin-keystore/reference/403).", "x-akamai": { "file-path": "errors/403.yaml" } }, "404": { "content": { "application/problem+json": { "examples": { "certificate-not-found": { "summary": "Client certificate not found", "value": { "detail": "The requested resource could not be found on the server.", "field": "certificateId", "instance": "32be8a77-cc41-495e-94d8-cb536afea149", "problemId": "32be8a77-cc41-495e-94d8-cb536afea149", "status": 404, "title": "Resource Not Found", "type": "resource-not-found", "value": "180131" } } }, "schema": { "additionalProperties": true, "description": "Schema for a problem.", "properties": { "detail": { "description": "__Read-only__ Explains the problem with any guidance on how to fix it.", "minLength": 1, "readOnly": true, "type": "string" }, "errors": { "description": "__Read-only__ The problem type errors.", "items": { "description": "A further nested HTTP problem object that describes individual errors.", "type": "object", "x-akamai": { "file-path": "schemas/http-problem-nested.yaml" } }, "minItems": 1, "readOnly": true, "type": "array" }, "instance": { "description": "__Read-only__ Non-navigable URI that identifies each occurrence of the problem.", "minLength": 1, "readOnly": true, "type": "string" }, "status": { "description": "__Read-only__ The HTTP status code.", "minimum": 1, "readOnly": true, "type": "integer" }, "title": { "description": "__Read-only__ Human readable summary of each error case.", "minLength": 1, "readOnly": true, "type": "string" }, "type": { "description": "__Read-only__ Non-navigable URI that identifies each error case.", "minLength": 1, "readOnly": true, "type": "string" } }, "required": [ "type" ], "title": "Generic problem", "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Not found](https://techdocs.akamai.com/mtls-origin-keystore/reference/404).", "x-akamai": { "file-path": "errors/404.yaml" } }, "405": { "content": { "application/problem+json": { "example": { "detail": "Request method 'PUT' is not supported", "instance": "8e13c4c3-003e-415d-bf33-6f6b949ae02f", "problemId": "8e13c4c3-003e-415d-bf33-6f6b949ae02f", "status": 405, "title": "Method Not Allowed", "type": "method-not-allowed" }, "schema": { "additionalProperties": true, "description": "Schema for a problem.", "properties": { "detail": { "description": "__Read-only__ Explains the problem with any guidance on how to fix it.", "minLength": 1, "readOnly": true, "type": "string" }, "errors": { "description": "__Read-only__ The problem type errors.", "items": { "description": "A further nested HTTP problem object that describes individual errors.", "type": "object", "x-akamai": { "file-path": "schemas/http-problem-nested.yaml" } }, "minItems": 1, "readOnly": true, "type": "array" }, "instance": { "description": "__Read-only__ Non-navigable URI that identifies each occurrence of the problem.", "minLength": 1, "readOnly": true, "type": "string" }, "status": { "description": "__Read-only__ The HTTP status code.", "minimum": 1, "readOnly": true, "type": "integer" }, "title": { "description": "__Read-only__ Human readable summary of each error case.", "minLength": 1, "readOnly": true, "type": "string" }, "type": { "description": "__Read-only__ Non-navigable URI that identifies each error case.", "minLength": 1, "readOnly": true, "type": "string" } }, "required": [ "type" ], "title": "Generic problem", "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Method not allowed](https://techdocs.akamai.com/mtls-origin-keystore/reference/405).", "x-akamai": { "file-path": "errors/405.yaml" } }, "415": { "content": { "application/problem+json": { "example": { "allowedMediaTypes": [ "application/vnd.akamai.mtls-origin-keystore.v1+json;charset=UTF-8" ], "detail": "Media type application/vd.akamai.mtls-origin-keystore.v1+json is not supported. Supported media types are [application/vnd.akamai.mtls-origin-keystore.v1+json;charset=UTF-8].", "status": 415, "title": "Media type not supported.", "type": "/mtls-origin-keystore/error-types/media-type-not-supported", "unsupportedMediaType": "application/vd.akamai.mtls-origin-keystore.v1+json" }, "schema": { "additionalProperties": true, "description": "Schema for a problem.", "properties": { "detail": { "description": "__Read-only__ Explains the problem with any guidance on how to fix it.", "minLength": 1, "readOnly": true, "type": "string" }, "errors": { "description": "__Read-only__ The problem type errors.", "items": { "description": "A further nested HTTP problem object that describes individual errors.", "type": "object", "x-akamai": { "file-path": "schemas/http-problem-nested.yaml" } }, "minItems": 1, "readOnly": true, "type": "array" }, "instance": { "description": "__Read-only__ Non-navigable URI that identifies each occurrence of the problem.", "minLength": 1, "readOnly": true, "type": "string" }, "status": { "description": "__Read-only__ The HTTP status code.", "minimum": 1, "readOnly": true, "type": "integer" }, "title": { "description": "__Read-only__ Human readable summary of each error case.", "minLength": 1, "readOnly": true, "type": "string" }, "type": { "description": "__Read-only__ Non-navigable URI that identifies each error case.", "minLength": 1, "readOnly": true, "type": "string" } }, "required": [ "type" ], "title": "Generic problem", "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Unsupported media type](https://techdocs.akamai.com/mtls-origin-keystore/reference/415). Wrong `Content-Type` header.", "x-akamai": { "file-path": "errors/415.yaml" } }, "429": { "content": { "application/problem+json": { "example": { "detail": "Too many overall requests to the service. This is unrelated to your client's rate limit. Please try after 2024-07-22T06:23:37.255Z", "httpStatus": "429 TOO_MANY_REQUESTS", "title": "Global Service Rate Limit Exceeded", "type": "global-rate-limit-exceeded" }, "schema": { "additionalProperties": true, "description": "Schema for a problem.", "properties": { "detail": { "description": "__Read-only__ Explains the problem with any guidance on how to fix it.", "minLength": 1, "readOnly": true, "type": "string" }, "errors": { "description": "__Read-only__ The problem type errors.", "items": { "description": "A further nested HTTP problem object that describes individual errors.", "type": "object", "x-akamai": { "file-path": "schemas/http-problem-nested.yaml" } }, "minItems": 1, "readOnly": true, "type": "array" }, "instance": { "description": "__Read-only__ Non-navigable URI that identifies each occurrence of the problem.", "minLength": 1, "readOnly": true, "type": "string" }, "status": { "description": "__Read-only__ The HTTP status code.", "minimum": 1, "readOnly": true, "type": "integer" }, "title": { "description": "__Read-only__ Human readable summary of each error case.", "minLength": 1, "readOnly": true, "type": "string" }, "type": { "description": "__Read-only__ Non-navigable URI that identifies each error case.", "minLength": 1, "readOnly": true, "type": "string" } }, "required": [ "type" ], "title": "Generic problem", "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } }, "text/html": { "example": "Too many overall requests to the service. This is unrelated to your client's rate limit. Please try after 2024-07-18T09:03:02.032Z", "schema": { "type": "string" } } }, "description": "[Too Many Requests](https://techdocs.akamai.com/mtls-origin-keystore/reference/429).", "headers": { "X-RateLimit-Limit": { "description": "Indicates how many total requests you are allowed to make in the current time window. You can't make more requests than this value. See [Rate Limiting](https://techdocs.akamai.com/mtls-origin-keystore/reference/rate-resource-limit).", "schema": { "example": 20, "type": "integer" }, "x-akamai": { "file-path": "headers/ratelimit-limit-header.v1.yaml" } }, "X-RateLimit-Next": { "description": "Indicates the time when you can make the next request after exhausting the allowed limit in the current time period. See [Rate Limiting](https://techdocs.akamai.com/mtls-origin-keystore/reference/rate-resource-limit).", "schema": { "example": "2023-11-08T05:54:01Z", "type": "string" }, "x-akamai": { "file-path": "headers/ratelimit-limit-next.v1.yaml" } }, "X-RateLimit-Remaining": { "description": "Indicates how many remaining requests you can make in the current time window. See [Rate Limiting](https://techdocs.akamai.com/mtls-origin-keystore/reference/rate-resource-limit).", "schema": { "example": 17, "type": "integer" }, "x-akamai": { "file-path": "headers/ratelimit-remaining-header.v1.yaml" } } }, "x-akamai": { "file-path": "errors/429.yaml" } }, "500": { "content": { "application/problem+json": { "example": { "detail": "An Unexpected error has occurred. Please contact Akamai support team to get it resolved.", "instance": "/mtls-origin-keystore/error-types/internal-error?traceId=-22899532639427393", "status": 500, "title": "An unexpected error occurred.", "type": "/mtls-origin-keystore/error-types/internal-error" }, "schema": { "additionalProperties": true, "description": "Schema for a problem.", "properties": { "detail": { "description": "__Read-only__ Explains the problem with any guidance on how to fix it.", "minLength": 1, "readOnly": true, "type": "string" }, "errors": { "description": "__Read-only__ The problem type errors.", "items": { "description": "A further nested HTTP problem object that describes individual errors.", "type": "object", "x-akamai": { "file-path": "schemas/http-problem-nested.yaml" } }, "minItems": 1, "readOnly": true, "type": "array" }, "instance": { "description": "__Read-only__ Non-navigable URI that identifies each occurrence of the problem.", "minLength": 1, "readOnly": true, "type": "string" }, "status": { "description": "__Read-only__ The HTTP status code.", "minimum": 1, "readOnly": true, "type": "integer" }, "title": { "description": "__Read-only__ Human readable summary of each error case.", "minLength": 1, "readOnly": true, "type": "string" }, "type": { "description": "__Read-only__ Non-navigable URI that identifies each error case.", "minLength": 1, "readOnly": true, "type": "string" } }, "required": [ "type" ], "title": "Generic problem", "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "[Internal server error](https://techdocs.akamai.com/mtls-origin-keystore/reference/500).", "x-akamai": { "file-path": "errors/500.yaml" } } }, "summary": "List client certificate versions", "tags": [ "Client certificate versions" ] }, "parameters": [ { "description": "Identifies each client certificate.", "in": "path", "name": "certificateId", "required": true, "schema": { "example": 1, "type": "integer" }, "x-akamai": { "file-path": "parameters/client-cert-id-path.yaml" } } ], "x-akamai": { "file-path": "paths/versions.yaml", "path-info": "/client-certificates/{certificateId}/versions" } } }, "servers": [ { "url": "https://{hostname}/mtls-origin-keystore/v1" } ], "x-akamai": { "auth-type": "EDGE_GRID", "file-path": "02-client-certificate-versions.yaml" }, "x-readme": { "samples-languages": [ "curl", "python", "node" ], "explorer-enabled": true, "proxy-enabled": true } } ``` # Sibling pages * [Rotate a client certificate](https://techdocs.akamai.com/mtls-origin-keystore/reference/post-client-cert-version.md) * [Delete a client certificate version](https://techdocs.akamai.com/mtls-origin-keystore/reference/delete-client-certificate.md) * [Upload a signed client certificate](https://techdocs.akamai.com/mtls-origin-keystore/reference/post-cert-block.md)