Skip to main content

GetDigitalCertificates

Retrieves a list of digital certificates with optional filtering by account, issuer, name, type, and active status.

Request

GET /nxt?requestType=getDigitalCertificates

All endpoints use port 22024 by default.

Parameters

NameTypeDescriptionRequired
accountstringAccount ID or SHAMWARI addressNo
issuerstringIssuer account ID or SHAMWARI addressNo
certificateNamestringCertificate nameNo
certificateTypestringCertificate typeNo
activeOnlybooleanOnly return active (non-revoked, non-expired) certificatesNo
firstIndexintPagination startNo
lastIndexintPagination endNo

Response

{
"certificates": [
{
"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
}
],
"account": "1234567890123456789",
"issuer": "9876543210123456789",
"errorCode": 0,
"errorDescription": ""
}

Example

curl "http://localhost:22024/nxt?requestType=getDigitalCertificates&account=SHAMWARI-ABCD-EFGH-IJKL-MNOPQ&activeOnly=true"