Credential Issuance APIs

Credential claim API

post

Authorizations

Body

credentialSchemaIdstringOptional

tagsstring[]Optional

Responses

201

Credential successfully issued!

application/json

400

Invalid Input

500

error

post

POST /api/v1/credentials/issue HTTP/1.1
Host: sunbirdrc.dev
Token: YOUR_API_KEY
Content-Type: appliation/json
Accept: */*
Content-Length: 226

{
  "credential": {
    "context": [
      "text"
    ],
    "id": "text",
    "type": "text",
    "issuer": {},
    "issuanceDate": "2025-05-02T18:20:49.668Z",
    "expirationDate": "2025-05-02T18:20:49.668Z",
    "credentialSubject": {}
  },
  "credentialSchemaId": "text",
  "tags": [
    "text"
  ]
}

{
  "credential": {
    "context": [
      "text"
    ],
    "id": "text",
    "type": "text",
    "issuer": {},
    "issuanceDate": "2025-05-02T18:20:49.668Z",
    "expirationDate": "2025-05-02T18:20:49.668Z",
    "credentialSubject": {},
    "proof": {
      "type": "text",
      "created": "text",
      "challenge": "text",
      "domain": "text",
      "nonce": "text",
      "verificationMethod": "text",
      "proofPurpose": "text",
      "jws": "text",
      "proofValue": "text"
    }
  },
  "credentialSchemaId": "text",
  "tags": [
    "text"
  ],
  "createdAt": "text",
  "updatedAt": "text",
  "createdBy": "text",
  "updatedBy": "text"
}

Get credentials by id

get

Authorizations

Path parameters

idstringRequired

Header parameters

templateIdstringOptional

acceptstring · enumRequiredPossible values:

Responses

200

OK

appliation/json

401

Not Authorized

404

Not Found

500

Error

get

GET /api/v1/credentials/{id} HTTP/1.1
Host: sunbirdrc.dev
Token: YOUR_API_KEY
accept: application/json
Accept: */*

{
  "context": [
    "text"
  ],
  "id": "text",
  "type": "text",
  "issuer": {},
  "issuanceDate": "2025-05-02T18:20:49.668Z",
  "expirationDate": "2025-05-02T18:20:49.668Z",
  "credentialSubject": {},
  "proof": {
    "type": "text",
    "created": "2025-05-02T18:20:49.668Z",
    "challenge": "text",
    "domain": "text",
    "nonce": "text",
    "verificationMethod": "text",
    "proofPurpose": "text",
    "jws": "text",
    "proofValue": "text"
  }
}

Revoke credentials by id

delete

Authorizations

Path parameters

idstringRequired

Responses

200

OK

appliation/json

401

Not Authorized

404

Not Found

500

Error

delete

DELETE /api/v1/credentials/{id} HTTP/1.1
Host: sunbirdrc.dev
Token: YOUR_API_KEY
Accept: */*

{
  "revocationListIndex": "text"
}

Search credentials by issuer and subject

post

Authorizations

Body

typestring · enumOptionalPossible values:

Responses

200

OK

appliation/json

401

Not Authorized

404

Not Found

500

Error

post

POST /api/v1/credentials/search HTTP/1.1
Host: sunbirdrc.dev
Token: YOUR_API_KEY
Content-Type: appliation/json
Accept: */*
Content-Length: 63

{
  "issuer": {
    "id": "text"
  },
  "subject": {
    "id": "text"
  },
  "type": "claim"
}

[
  {
    "context": [
      "text"
    ],
    "id": "text",
    "type": "text",
    "issuer": {},
    "issuanceDate": "2025-05-02T18:20:49.668Z",
    "expirationDate": "2025-05-02T18:20:49.668Z",
    "credentialSubject": {},
    "proof": {
      "type": "text",
      "created": "2025-05-02T18:20:49.668Z",
      "challenge": "text",
      "domain": "text",
      "nonce": "text",
      "verificationMethod": "text",
      "proofPurpose": "text",
      "jws": "text",
      "proofValue": "text"
    }
  }
]

Verifies a verifiableCredential and returns a verificationResult in the response body.

get

Verifies a verifiableCredential and returns a verificationResult in the response body.

Authorizations

Path parameters

idstringRequired

Responses

200

OK

appliation/json

get

GET /api/v1/credentials/{id}/verify HTTP/1.1
Host: sunbirdrc.dev
Token: YOUR_API_KEY
Accept: */*

200

OK

{
  "status": "Active",
  "checks": [
    {
      "active": "OK",
      "revoked": "OK",
      "expired": "OK",
      "proof": "OK"
    }
  ],
  "warnings": [
    "text"
  ],
  "errors": [
    "text"
  ]
}

Complete list of revoked credentials (Need to be discussed)

get

Authorizations

Query parameters

issuerIdstringRequired

The ID of the issuer

pagestringRequired

The page number

limitstringRequired

The limit of items per page

Responses

200

OK

appliation/json

Responseobject[]

404

Not Found

500

Error

get

GET /api/v1/credentials/revocation-list HTTP/1.1
Host: sunbirdrc.dev
Token: YOUR_API_KEY
Accept: */*

[
  {}
]