Issuers
Blockchain Badges Issuers.
An Issuer represents an entity or organization responsible for defining, creating, and awarding digital badges to acknowledge and verify individual achievements, skills, or competencies.
new_issuer
Use this API operation to set up a new Issuer, enabling them to design and issue digital badges and manage awards efficiently. This operation is the first step in establishing a trusted source for verifiable credentials within your platform.
POST
https://api.bws.ninja/v1/call
Request Body
solution*
string
BWS.Blockchain.Badges
operation*
string
new_issuer
parameters*
JSON
new_issuer Method Parameters
Use an email address you have access to! To confirm your authorization to use the provided email, we will send a verification message to it (How to Verify a Badge Issuer).
name
string
Issuer Name (e.g. "Blockchain Academy")
url
string
Issuer website URL
string
The issuer contact email address.
new_issuer API Call Example
new_issuer Call Response
When the API call is successfully executed, it returns the issuerId
, which also serves as the URL to retrieve the Issuer's Open Badge v2.0 JSON.
This JSON file contains metadata about the Badge Issuer, including essential information such as the organization's name, description, and verification details, formatted according to the Open Badge standard for interoperability and trust.
When you create a new Badge Issuer, we send an email for verification, including a verification link and a verification code.
To verify an Issuer, you - or someone with access to the provided email inbox - should click on the verification link or send you the verification code (once you get the code, use the verify_issuer API call to verify the issuer).
Only verified issuers can create and award badges.
Only verified issuers can create and award badges, ensuring high trust and authenticity in the digital credentialing system.
verify_issuer
To legitimate badge issuers, we send a verification link and code to the address you use when calling new_issuer API call operation.
Use the following operation to verify an issuer using the provided code.
POST
https://api.bws.ninja/v1/call
Request Body
solution*
string
BWS.Blockchain.Badges
operation*
string
verify_issuer
parameters*
JSON
verify_issuer Method Parameters
issuerId
string
code
string
The code you received by email.
verify_issuer API Call Example
verify_issuer Call Response
When the API call is successfully executed and the issuer gets verified, you will get a 200 status code.
list_issuers
Get the list of the issuers you created.
POST
https://api.bws.ninja/v1/call
Request Body
solution*
string
BWS.Blockchain.Badges
operation*
string
list_issuers
list_issuers API Call Example
list_issuers Call Response
Once executed correctly, you will get a list of your account issuers.
delete_issuer
Use this API operation to delete an existing Issuer.
You can only delete issuers with no active Badges!
Only issuers that have not awarded any badge can be deleted.
POST
https://api.bws.ninja/v1/call
Request Body
solution*
string
BWS.Blockchain.Badges
operation*
string
delete_issuer
parameters*
JSON
delete_issuer Method Parameters
issuerId
string
delete_issuer API Call Example
delete_issuer Call Response
When the API call is successfully executed, you will get an OK status response code.
Last updated