DIdigicert
CSC (v0)

Get credential details

Use this endpoint to get credential and identity information, certificate public key and CA certificates for the given credential ID.

credentialID is required in the request body.

post/csc/v0/credentials/info

Request

Request body

certificatesstring

Specifies which certificates from the certificate chain shall be returned in certs/certificates.

langstring

Request a preferred language according to RFC 3066. If specified, the Remote Service should return the label and drescription parameters in this launguage, if supported. If the language is not supported by the Remote Service, it should specify the default language in the output lang parameter. If omitted, the Remote Service should return these parameters in its own default language.

clientDatastring

Arbitrary data from the Signature Application. It can be used to handle a transaction identifier or other application-specific data.

credentialIDstring required

The identifier associated to the credential.

certInfoboolean

Specifies if the information on the end entity certificate shall be returned as printable strings. This is useful in case the Signature Application wants to retrieve some details of the certificate without having to decode it. The default value is “false”, so if the parameter is omitted then the information will not be returned.

authInfoboolean

Specifies if the information on the authorization mechanisms supported by this credential (PIN and OTP groups) shall be returned. The default value is “false”, so if the parameter is omitted then the information will not be returned.

Example request

{
  "certificates": "chain",
  "credentialID": "GX0112348",
  "certInfo": true,
  "authInfo": true
}

Response

Credential details

descriptionstring

A free form description of the credential in the lang language. The maximum size of the string is 255 characters.

authModestring

Specifies one of the authorization modes

langstring

Order

SCALstring

Specifies the Sole Control Assurance Level required by the credential, as defined in CEN EN 419 241-1

Example response

{
  "authMode": "explicit",
  "lang": "en-US",
  "key": {
    "status": "active",
    "algo": [
      "1.2.840.113549.1.1.1",
      "0.4.0.127.0.7.1.1.4.1.3"
    ],
    "len": 2048
  },
  "cert": {
    "status": "valid",
    "issuerDN": "The X.500 issuer DN printable string",
    "serialNumber": "5AAC41CD8FA22B9536",
    "subjectDN": "The X.500 subject DN printable string",
    "validFrom": "20160101100000Z",
    "validTo": "20190101095959Z"
  },
  "PIN": {
    "label": "PIN",
    "description": "Please type the signature PIN"
  },
  "OTP": {
    "type": "offline",
    "provider": "totp",
    "format": "N",
    "label": "Mobile OTP",
    "description": "Please type the 6 digit code you received on your registered mobile phone",
    "ID": "MB01-K741200"
  }
}

Changes

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