GetInstalledCertificateIds

Lists the certificates currently installed on the station, by hash.

Version: OCPP 2.0.1
Direction: CSMS → Charge Point
Functional block: Security

The inventory step of certificate management: read what is installed before deciding what to add or remove.

Request

Field	Type	Required	Description
`certificateType`	GetCertificateIdUseEnumType[]	Optional	Which kinds to list. Omit for all.

json

[2, "19223201", "GetInstalledCertificateIds", {
  "certificateType": ["CSMSRootCertificate"]
}]

Response

Field	Type	Required	Description
`status`	GetInstalledCertificateStatusEnumType	Required	`Accepted` or `NotFound`.
`certificateHashDataChain`	CertificateHashDataChainType[]	Optional	Hash data for each installed certificate.
`statusInfo`	StatusInfoType	Optional	Reason code.

json

[3, "19223201", {
  "status": "Accepted",
  "certificateHashDataChain": [{
    "certificateType": "CSMSRootCertificate",
    "certificateHashData": {
      "hashAlgorithm": "SHA256",
      "issuerNameHash": "3d8f...",
      "issuerKeyHash": "9b21...",
      "serialNumber": "0a1b2c3d"
    }
  }]
}]

Implementation notes

The hash data returned here is exactly what DeleteCertificate expects. Read, then delete by the hash you were given rather than reconstructing it.

NotFound means nothing of the requested type is installed — not an error.