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
| Parameter | Location | Required | Type | Description |
|---|---|---|---|---|
Authorization | Header | Yes | Bearer Token | The access_token received in the credential acquisition token response |
credentialID | JSON Body | Yes | String | The signing credential identifier received in the token response |
certInfo | JSON Body | No | Boolean | true to return detailed certificate information |
certificates | JSON Body | No | String | Static value single |
authInfo | JSON Body | No | Boolean | true 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
| Parameter | Type | Description | Integrator Validation |
|---|---|---|---|
description | String | Signing credential description/profile | May be used for display or diagnostic purposes |
key.status | String | Key status | Expected value for signing is enabled |
key.algo | Array of String | Signature algorithm OIDs permitted for this signing credential | Only values from this list may be used as signAlgo |
key.len | Number | EC key length in bits | Expected value for this profile is 384 |
key.curve | String | Elliptic curve OID | Expected value for secp384r1 is 1.3.132.0.34 |
cert.status | String | Certificate status | Expected value before signing is valid |
cert.certificates | Array of String | Base64-encoded DER certificate | Decode, parse, and use for signature verification |
cert.serialNumber | String | Certificate serial number | May be stored for audit purposes if required |
cert.validFrom | String | Certificate validity start time | Validate against the current time |
cert.validTo | String | Certificate validity end time | Validate against the current time and complete signing before expiration |
cert.issuerDN | String | Issuer Distinguished Name (DN) | Validate the trust chain |
cert.subjectDN | String | Signer's Distinguished Name (DN) | May be stored for audit purposes if required |
auth.mode | String | Required authorization mechanism | Expected static value oauth2code |
multisign | Number | Maximum number of signatures allowed within a single authorization | Must not be exceeded and should be aligned with numSignatures / number of hashes |
signatureQualifier | String | Credential signature qualification level | Expected static value eu_eidas_qes |
SCAL | String | Signature Creation Application Level | Expected static value 2 |
Updated about 2 months ago
Did this page help you?