Credential Issuance APIs

Credential claim API

post

Authorizations

Authorization

TokenstringRequired

Body

appliation/json

credentialSchemaIdstringOptional

tagsstring[]Optional

Responses

201

Credential successfully issued!

application/json

400

Invalid Input

500

error

post

/credentials/issue

HTTPcURLJavaScriptPython

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-12-15T22:03:07.948Z",
    "expirationDate": "2025-12-15T22:03:07.948Z",
    "credentialSubject": {}
  },
  "credentialSchemaId": "text",
  "tags": [
    "text"
  ]
}

{
  "credential": {
    "context": [
      "text"
    ],
    "id": "text",
    "type": "text",
    "issuer": {},
    "issuanceDate": "2025-12-15T22:03:07.948Z",
    "expirationDate": "2025-12-15T22:03:07.948Z",
    "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

Authorization

TokenstringRequired

Path parameters

idstringRequired

Header parameters

templateIdstringOptional

acceptstring · enumRequiredPossible values:

Responses

200

OK

appliation/json

401

Not Authorized

404

Not Found

500

Error

get

/credentials/{id}

HTTPcURLJavaScriptPython

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-12-15T22:03:07.948Z",
  "expirationDate": "2025-12-15T22:03:07.948Z",
  "credentialSubject": {},
  "proof": {
    "type": "text",
    "created": "2025-12-15T22:03:07.948Z",
    "challenge": "text",
    "domain": "text",
    "nonce": "text",
    "verificationMethod": "text",
    "proofPurpose": "text",
    "jws": "text",
    "proofValue": "text"
  }
}

Revoke credentials by id

delete

Authorizations

Authorization

TokenstringRequired

Path parameters

idstringRequired

Responses

200

OK

appliation/json

401

Not Authorized

404

Not Found

500

Error

delete

/credentials/{id}

HTTPcURLJavaScriptPython

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

Authorization

TokenstringRequired

Body

appliation/json

typestring · enumOptionalPossible values:

Responses

200

OK

appliation/json

401

Not Authorized

404

Not Found

500

Error

post

/credentials/search

HTTPcURLJavaScriptPython

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-12-15T22:03:07.948Z",
    "expirationDate": "2025-12-15T22:03:07.948Z",
    "credentialSubject": {},
    "proof": {
      "type": "text",
      "created": "2025-12-15T22:03:07.948Z",
      "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

Authorization

TokenstringRequired

Path parameters

idstringRequired

Responses

200

OK

appliation/json

get

/credentials/{id}/verify

HTTPcURLJavaScriptPython

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

Authorization

TokenstringRequired

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

/credentials/revocation-list

HTTPcURLJavaScriptPython

GET /api/v1/credentials/revocation-list?issuerId=text&page=text&limit=text HTTP/1.1
Host: sunbirdrc.dev
Token: YOUR_API_KEY
Accept: */*

[
  {}
]