Skip to main content

GetDigitalCertificate

Retrieves a digital certificate either by its ID or by the combination of account, issuer, name, and type.

Request

GET /nxt?requestType=getDigitalCertificate

All endpoints use port 22024 by default.

Parameters

NameTypeDescriptionRequired
certificatestringCertificate ID (unsigned long)Yes*
accountstringAccount ID or SHAMWARI addressYes*
issuerstringIssuer account ID or SHAMWARI addressYes*
certificateNamestringCertificate nameYes*
certificateTypestringCertificate typeYes*

*Provide either certificate OR all of account+issuer+certificateName+certificateType.

Response

{
"certificate": "9876543210123456789",
"name": "IdentityCert",
"type": "IDENTITY",
"account": "1234567890123456789",
"issuer": "9876543210123456789",
"issuerRS": "SHAMWARI-ABCD-EFGH-IJKL-MNOPQ",
"timestamp": 1700000000,
"expirationTimestamp": 1893456000,
"signature": "hex_encoded_signature...",
"canonicalContent": "hex_encoded_content...",
"revoked": false,
"active": true,
"errorCode": 0,
"errorDescription": ""
}

Error Codes

CodeDescription
3Missing parameters
4Invalid certificate ID format
5Certificate not found

Example

curl "http://localhost:22024/nxt?requestType=getDigitalCertificate&certificate=9876543210123456789"