Step 2: Retrieve Signing Credential Information

The request returns information about the signing credential, including its public key, certificate, supported algorithms, authorization details, and signing capabilities.

HTTP Request

POST {{csc_base_url}}/credentials/info
Authorization: Bearer {{access_token}}
Accept: application/json
Content-Type: application/json
 
{
"credentialID": "{{credential_id}}",
"certInfo": true,
"certificates": "single",
"authInfo": true
}

 

Input Parameters

ParameterLocationRequiredTypeDescription
AuthorizationHeaderYesBearer TokenThe access_token received in the credential acquisition token response
credentialIDJSON BodyYesStringThe signing credential identifier received in the token response
certInfoJSON BodyNoBooleantrue to return detailed certificate information
certificatesJSON BodyNoStringStatic value single
authInfoJSON BodyNoBooleantrue to return signing credential authorization information

 Response Example:

{
"description": "eparaksts:serveridstc:sign",
"key": {
"status": "enabled",
"algo": [
"1.2.840.10045.4.3.2",
"1.2.840.10045.4.3.3",
"1.2.840.10045.4.3.4"
],
"len": 384,
"curve": "1.3.132.0.34"
},
"cert": {
"status": "valid",
"certificates": [
"<Base64-DER-certificate>"
],
"serialNumber": "<certificate-serial-number>",
"validFrom": "20260813080931Z",
"validTo": "20260813082400Z",
"issuerDN": "<issuer distinguished name>",
"subjectDN": "<subject distinguished name>"
},
"auth": {
"mode": "oauth2code"
},
"multisign": 40,
"lang": "lv",
"signatureQualifier": "eu_eidas_qes",
"SCAL": "2"
}

Response Parameters and Validation

ParameterTypeDescriptionIntegrator Validation
descriptionStringSigning credential description/profileMay be used for display or diagnostic purposes
key.statusStringKey statusExpected value for signing is enabled
key.algoArray of StringSignature algorithm OIDs permitted for this signing credentialOnly values from this list may be used as signAlgo
key.lenNumberEC key length in bitsExpected value for this profile is 384
key.curveStringElliptic curve OIDExpected value for secp384r1 is 1.3.132.0.34
cert.statusStringCertificate statusExpected value before signing is valid
cert.certificatesArray of StringBase64-encoded DER certificateDecode, parse, and use for signature verification
cert.serialNumberStringCertificate serial numberMay be stored for audit purposes if required
cert.validFromStringCertificate validity start timeValidate against the current time
cert.validToStringCertificate validity end timeValidate against the current time and complete signing before expiration
cert.issuerDNStringIssuer Distinguished Name (DN)Validate the trust chain
cert.subjectDNStringSigner's Distinguished Name (DN)May be stored for audit purposes if required
auth.modeStringRequired authorization mechanismExpected static value oauth2code
multisignNumberMaximum number of signatures allowed within a single authorizationMust not be exceeded and should be aligned with numSignatures / number of hashes
signatureQualifierStringCredential signature qualification levelExpected static value eu_eidas_qes
SCALStringSignature Creation Application LevelExpected static value 2

Did this page help you?