Badgeclasses
false
OK
Bad Request
GET /v2/badgeclasses/{idOrEntityId} HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"id": "68e9d238c5afe622816febb3",
"entityType": "BadgeClass",
"entityId": "iOMWsaF1QbmMCofM54JlUg",
"openBadgeId": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg",
"sourceUrl": "https://example.com/badge-classes/1",
"originalJson": "{}",
"createdAt": "2025-08-25T10:50:33.272Z",
"createdBy": "Hey7J-GRSJeu6FNnHQwNyw",
"issuer": "ZvYydoQhRtOKalNzFPZR2A-Q",
"issuerOpenBadgeId": "https://api.badgr.io/public/issuers/ZvYydoQhRtOKalNzFPZR2A",
"name": "Math Expert",
"image": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image",
"description": "This badge is awarded to students who have demonstrated mastery of Math.",
"achievementType": "Course",
"criteriaUrl": "https://example.com/badge-classes/1/criteria",
"criteriaNarrative": "text",
"alignments": [
{
"targetName": "text",
"targetUrl": "text",
"targetDescription": "text",
"targetFramework": "text",
"targetCode": "text",
"displayAsSkill": true
}
],
"tags": [
"text"
],
"expires": {
"amount": 30,
"duration": "days"
},
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"source": "local",
"imagePath": "uploads/badges/badgeclass-lY1LJ6K4RqG7ThGLYvWNng.png",
"archived": true,
"archivedDate": "2025-08-25T10:50:33.272Z",
"archivalNote": "text",
"ob3Properties": {
"creditHours": 36,
"fieldOfStudy": "Research",
"humanCode": "R1",
"specialization": "Computer Science Research"
},
"preferences": {
"includeOnPublicPages": true,
"customPropertyValues": [
{
"propertyId": "67b32887e2a7a7d5f7adabf1",
"stringValue": "text",
"doubleValue": 1,
"arrayValue": [
"text"
],
"public": true
}
],
"enabledPrintCertTemplateIds": [
"61e9d238c5afe622816febb3"
],
"defaultPrintCertTemplateId": "61e9d238c5afe622816febb3"
}
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
Previously awarded Assertions will be updated with image rebaking
Name of the BadgeClass
Math Expert
Short description of the BadgeClass
This badge is awarded to students who have demonstrated mastery of Math.
Image of the issuer. An URL or a bas64 encoded images.
https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image
The type of achievement
Course
External URL that describes in a human-readable format the criteria for the BadgeClass
https://example.com/badge-classes/1/criteria
Markdown formatted description of the criteria
List of tags that describe the BadgeClass
OK
Bad Request
PUT /v2/badgeclasses/{idOrEntityId} HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 974
{
"name": "Math Expert",
"description": "This badge is awarded to students who have demonstrated mastery of Math.",
"image": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image",
"achievementType": "Course",
"criteriaUrl": "https://example.com/badge-classes/1/criteria",
"criteriaNarrative": "text",
"tags": [
"text"
],
"alignments": [
{
"targetName": "text",
"targetUrl": "text",
"targetDescription": "text",
"targetFramework": "text",
"targetCode": "text",
"displayAsSkill": true
}
],
"expires": {
"amount": 30,
"duration": "days"
},
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"ob3Properties": {
"creditHours": 36,
"fieldOfStudy": "Research",
"humanCode": "R1",
"specialization": "Computer Science Research"
},
"preferences": {
"includeOnPublicPages": true,
"customPropertyValues": [
{
"propertyId": "67b32887e2a7a7d5f7adabf1",
"stringValue": "text",
"doubleValue": 1,
"arrayValue": [
"text"
],
"public": true
}
],
"enabledPrintCertTemplateIds": [
"61e9d238c5afe622816febb3"
],
"defaultPrintCertTemplateId": "61e9d238c5afe622816febb3"
}
}
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"id": "68e9d238c5afe622816febb3",
"entityType": "BadgeClass",
"entityId": "iOMWsaF1QbmMCofM54JlUg",
"openBadgeId": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg",
"sourceUrl": "https://example.com/badge-classes/1",
"originalJson": "{}",
"createdAt": "2025-08-25T10:50:33.272Z",
"createdBy": "Hey7J-GRSJeu6FNnHQwNyw",
"issuer": "ZvYydoQhRtOKalNzFPZR2A-Q",
"issuerOpenBadgeId": "https://api.badgr.io/public/issuers/ZvYydoQhRtOKalNzFPZR2A",
"name": "Math Expert",
"image": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image",
"description": "This badge is awarded to students who have demonstrated mastery of Math.",
"achievementType": "Course",
"criteriaUrl": "https://example.com/badge-classes/1/criteria",
"criteriaNarrative": "text",
"alignments": [
{
"targetName": "text",
"targetUrl": "text",
"targetDescription": "text",
"targetFramework": "text",
"targetCode": "text",
"displayAsSkill": true
}
],
"tags": [
"text"
],
"expires": {
"amount": 30,
"duration": "days"
},
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"source": "local",
"imagePath": "uploads/badges/badgeclass-lY1LJ6K4RqG7ThGLYvWNng.png",
"archived": true,
"archivedDate": "2025-08-25T10:50:33.272Z",
"archivalNote": "text",
"ob3Properties": {
"creditHours": 36,
"fieldOfStudy": "Research",
"humanCode": "R1",
"specialization": "Computer Science Research"
},
"preferences": {
"includeOnPublicPages": true,
"customPropertyValues": [
{
"propertyId": "67b32887e2a7a7d5f7adabf1",
"stringValue": "text",
"doubleValue": 1,
"arrayValue": [
"text"
],
"public": true
}
],
"enabledPrintCertTemplateIds": [
"61e9d238c5afe622816febb3"
],
"defaultPrintCertTemplateId": "61e9d238c5afe622816febb3"
}
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
Restricted to owners or editors (not staff) of the corresponding Issuer.
BadgeClass deleted
Bad Request
DELETE /v2/badgeclasses/{idOrEntityId} HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"status": {
"success": true,
"description": "ok"
},
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
The label of the claim code
Conference Event
The number of times the claim code can be used
10
OK
Bad Request
PUT /v2/badgeclasses/{idOrEntityId}/claim-codes/{claimCode} HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 83
{
"label": "Conference Event",
"limit": 10,
"expirationDate": "2025-08-25T10:50:33.272Z"
}
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"code": "5678945",
"createdAt": "2025-08-25T10:50:33.272Z",
"label": "Conference Event",
"limit": 10,
"expirationDate": "2025-08-25T10:50:33.272Z",
"enabled": true,
"claimCount": 1,
"claimUrl": "text"
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
No Content
Bad Request
DELETE /v2/badgeclasses/{idOrEntityId}/claim-codes/{claimCode} HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"status": {
"success": true,
"description": "ok"
},
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
false
OK
Bad Request
GET /v2/badgeclasses/ref/{ref} HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"id": "68e9d238c5afe622816febb3",
"entityType": "BadgeClass",
"entityId": "iOMWsaF1QbmMCofM54JlUg",
"openBadgeId": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg",
"sourceUrl": "https://example.com/badge-classes/1",
"originalJson": "{}",
"createdAt": "2025-08-25T10:50:33.272Z",
"createdBy": "Hey7J-GRSJeu6FNnHQwNyw",
"issuer": "ZvYydoQhRtOKalNzFPZR2A-Q",
"issuerOpenBadgeId": "https://api.badgr.io/public/issuers/ZvYydoQhRtOKalNzFPZR2A",
"name": "Math Expert",
"image": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image",
"description": "This badge is awarded to students who have demonstrated mastery of Math.",
"achievementType": "Course",
"criteriaUrl": "https://example.com/badge-classes/1/criteria",
"criteriaNarrative": "text",
"alignments": [
{
"targetName": "text",
"targetUrl": "text",
"targetDescription": "text",
"targetFramework": "text",
"targetCode": "text",
"displayAsSkill": true
}
],
"tags": [
"text"
],
"expires": {
"amount": 30,
"duration": "days"
},
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"source": "local",
"imagePath": "uploads/badges/badgeclass-lY1LJ6K4RqG7ThGLYvWNng.png",
"archived": true,
"archivedDate": "2025-08-25T10:50:33.272Z",
"archivalNote": "text",
"ob3Properties": {
"creditHours": 36,
"fieldOfStudy": "Research",
"humanCode": "R1",
"specialization": "Computer Science Research"
},
"preferences": {
"includeOnPublicPages": true,
"customPropertyValues": [
{
"propertyId": "67b32887e2a7a7d5f7adabf1",
"stringValue": "text",
"doubleValue": 1,
"arrayValue": [
"text"
],
"public": true
}
],
"enabledPrintCertTemplateIds": [
"61e9d238c5afe622816febb3"
],
"defaultPrintCertTemplateId": "61e9d238c5afe622816febb3"
}
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
Previously awarded Assertions will be updated with image rebaking
Name of the BadgeClass
Math Expert
Short description of the BadgeClass
This badge is awarded to students who have demonstrated mastery of Math.
Image of the issuer. An URL or a bas64 encoded images.
https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image
The type of achievement
Course
External URL that describes in a human-readable format the criteria for the BadgeClass
https://example.com/badge-classes/1/criteria
Markdown formatted description of the criteria
List of tags that describe the BadgeClass
OK
Bad Request
PUT /v2/badgeclasses/ref/{ref} HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 974
{
"name": "Math Expert",
"description": "This badge is awarded to students who have demonstrated mastery of Math.",
"image": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image",
"achievementType": "Course",
"criteriaUrl": "https://example.com/badge-classes/1/criteria",
"criteriaNarrative": "text",
"tags": [
"text"
],
"alignments": [
{
"targetName": "text",
"targetUrl": "text",
"targetDescription": "text",
"targetFramework": "text",
"targetCode": "text",
"displayAsSkill": true
}
],
"expires": {
"amount": 30,
"duration": "days"
},
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"ob3Properties": {
"creditHours": 36,
"fieldOfStudy": "Research",
"humanCode": "R1",
"specialization": "Computer Science Research"
},
"preferences": {
"includeOnPublicPages": true,
"customPropertyValues": [
{
"propertyId": "67b32887e2a7a7d5f7adabf1",
"stringValue": "text",
"doubleValue": 1,
"arrayValue": [
"text"
],
"public": true
}
],
"enabledPrintCertTemplateIds": [
"61e9d238c5afe622816febb3"
],
"defaultPrintCertTemplateId": "61e9d238c5afe622816febb3"
}
}
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"id": "68e9d238c5afe622816febb3",
"entityType": "BadgeClass",
"entityId": "iOMWsaF1QbmMCofM54JlUg",
"openBadgeId": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg",
"sourceUrl": "https://example.com/badge-classes/1",
"originalJson": "{}",
"createdAt": "2025-08-25T10:50:33.272Z",
"createdBy": "Hey7J-GRSJeu6FNnHQwNyw",
"issuer": "ZvYydoQhRtOKalNzFPZR2A-Q",
"issuerOpenBadgeId": "https://api.badgr.io/public/issuers/ZvYydoQhRtOKalNzFPZR2A",
"name": "Math Expert",
"image": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image",
"description": "This badge is awarded to students who have demonstrated mastery of Math.",
"achievementType": "Course",
"criteriaUrl": "https://example.com/badge-classes/1/criteria",
"criteriaNarrative": "text",
"alignments": [
{
"targetName": "text",
"targetUrl": "text",
"targetDescription": "text",
"targetFramework": "text",
"targetCode": "text",
"displayAsSkill": true
}
],
"tags": [
"text"
],
"expires": {
"amount": 30,
"duration": "days"
},
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"source": "local",
"imagePath": "uploads/badges/badgeclass-lY1LJ6K4RqG7ThGLYvWNng.png",
"archived": true,
"archivedDate": "2025-08-25T10:50:33.272Z",
"archivalNote": "text",
"ob3Properties": {
"creditHours": 36,
"fieldOfStudy": "Research",
"humanCode": "R1",
"specialization": "Computer Science Research"
},
"preferences": {
"includeOnPublicPages": true,
"customPropertyValues": [
{
"propertyId": "67b32887e2a7a7d5f7adabf1",
"stringValue": "text",
"doubleValue": 1,
"arrayValue": [
"text"
],
"public": true
}
],
"enabledPrintCertTemplateIds": [
"61e9d238c5afe622816febb3"
],
"defaultPrintCertTemplateId": "61e9d238c5afe622816febb3"
}
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
Restricted to owners or editors (not staff) of the corresponding Issuer.
BadgeClass deleted
Bad Request
DELETE /v2/badgeclasses/ref/{ref} HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"status": {
"success": true,
"description": "ok"
},
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
A recipient identifier to filter by
Request pagination of results, before/after cursors may be provided in response header
false
false
Pagination cursor provided in "Link" response header
Pagination cursor provided in "Link" response header
List of Assertions
Bad Request
GET /v2/{scope}/{idOrEntityId}/assertions HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"entityType": "Assertion",
"id": "6116c84d1ff787222b6c4d15",
"entityId": "i9CirfwJTuSfiqg0FFUBdQ",
"openBadgeId": "https://api.badgr.io/public/assertions/i9CirfwJTuSfiqg0FFUBdQ",
"createdAt": "2025-08-25T10:50:33.272Z",
"createdBy": "Hey7J-GRSJeu6FNnHQwNyw",
"badgeclass": "K829IK8RS6ercwkpeFOn-Q",
"badgeclassOpenBadgeId": "https://api.badgr.io/public/badges/K829IK8RS6ercwkpeFOn-Q",
"issuer": "ZvYydoQhRtOKalNzFPZR2A-Q",
"issuerOpenBadgeId": "https://api.badgr.io/public/issuers/ZvYydoQhRtOKalNzFPZR2A",
"image": "https://api.badgr.io/public/assertions/SsCfI7FlTr6hAJe4irXnfQ/image",
"recipient": {
"identity": "sha256$4c2657856f",
"hashed": true,
"type": "email",
"salt": "jgsu868",
"plaintextIdentity": "[email protected]"
},
"issuedOn": "2025-08-25T10:50:33.272Z",
"narrative": "text",
"evidence": [
{
"url": "https://example.com",
"narrative": "text",
"name": "text",
"description": "text",
"genre": "text",
"audience": "text"
}
],
"revoked": true,
"revocationReason": "text",
"acceptance": "Unaccepted",
"expires": "2025-08-25T10:50:33.272Z",
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"assertionRef": {
"assertionUrl": "https://api.badgr.io/public/assertions/lY1LJ6K4RqG7ThGLYvWNng"
},
"badgeRef": {
"badgeUrl": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg"
},
"issuerRef": {
"issuerUrl": "https://api.badgr.ws/public/issuers/Uu4wd2I1SKmD3vmtMJ19hw"
},
"pending": true,
"source": "local",
"sourceUrl": "https://example.com/assertions/1",
"originalJson": "{}",
"imagePath": "uploads/badges/assertion-lY1LJ6K4RqG7ThGLYvWNng.png",
"ob3AwardProperties": {
"activityStart": "2025-08-25T10:50:33.272Z",
"activityEnd": "2025-08-25T10:50:33.272Z",
"licenseNumber": "text",
"role": "text"
}
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
The entity ID of the selected scope entity
K829IK8RS6ercwkpeFOn-Q
Request to award an assertion. When request scope is issuers, one of badgeclass or badgeclassOpenBadgeId must be provided.
ID or Entity ID of the badge class to be awarded
K829IK8RS6ercwkpeFOn-Q
OB URL of the badge class to be awarded
https://api.badgr.io/public/badges/K829IK8RS6ercwkpeFOn-Q
Timestamp when the assertion was issued
If set to false and the recipient already has this assertion, then the request will fail
Markdown narrative of the achievement
Created
Bad Request
POST /v2/{scope}/{idOrEntityId}/assertions HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 650
{
"badgeclass": "K829IK8RS6ercwkpeFOn-Q",
"badgeclassOpenBadgeId": "https://api.badgr.io/public/badges/K829IK8RS6ercwkpeFOn-Q",
"issuedOn": "2025-08-25T10:50:33.272Z",
"recipient": {
"identity": "[email protected]",
"type": "email",
"hashed": true
},
"allowDuplicateAwards": true,
"narrative": "text",
"evidence": [
{
"url": "https://example.com",
"narrative": "text",
"name": "text",
"description": "text",
"genre": "text",
"audience": "text"
}
],
"extensions": {
"value": {
"ANY_ADDITIONAL_PROPERTY": {}
}
},
"expires": "2025-08-25T10:50:33.272Z",
"ob3AwardProperties": {
"activityStart": "2025-08-25T10:50:33.272Z",
"activityEnd": "2025-08-25T10:50:33.272Z",
"licenseNumber": "text",
"role": "text"
}
}
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"entityType": "Assertion",
"id": "6116c84d1ff787222b6c4d15",
"entityId": "i9CirfwJTuSfiqg0FFUBdQ",
"openBadgeId": "https://api.badgr.io/public/assertions/i9CirfwJTuSfiqg0FFUBdQ",
"createdAt": "2025-08-25T10:50:33.272Z",
"createdBy": "Hey7J-GRSJeu6FNnHQwNyw",
"badgeclass": "K829IK8RS6ercwkpeFOn-Q",
"badgeclassOpenBadgeId": "https://api.badgr.io/public/badges/K829IK8RS6ercwkpeFOn-Q",
"issuer": "ZvYydoQhRtOKalNzFPZR2A-Q",
"issuerOpenBadgeId": "https://api.badgr.io/public/issuers/ZvYydoQhRtOKalNzFPZR2A",
"image": "https://api.badgr.io/public/assertions/SsCfI7FlTr6hAJe4irXnfQ/image",
"recipient": {
"identity": "sha256$4c2657856f",
"hashed": true,
"type": "email",
"salt": "jgsu868",
"plaintextIdentity": "[email protected]"
},
"issuedOn": "2025-08-25T10:50:33.272Z",
"narrative": "text",
"evidence": [
{
"url": "https://example.com",
"narrative": "text",
"name": "text",
"description": "text",
"genre": "text",
"audience": "text"
}
],
"revoked": true,
"revocationReason": "text",
"acceptance": "Unaccepted",
"expires": "2025-08-25T10:50:33.272Z",
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"assertionRef": {
"assertionUrl": "https://api.badgr.io/public/assertions/lY1LJ6K4RqG7ThGLYvWNng"
},
"badgeRef": {
"badgeUrl": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg"
},
"issuerRef": {
"issuerUrl": "https://api.badgr.ws/public/issuers/Uu4wd2I1SKmD3vmtMJ19hw"
},
"pending": true,
"source": "local",
"sourceUrl": "https://example.com/assertions/1",
"originalJson": "{}",
"imagePath": "uploads/badges/assertion-lY1LJ6K4RqG7ThGLYvWNng.png",
"ob3AwardProperties": {
"activityStart": "2025-08-25T10:50:33.272Z",
"activityEnd": "2025-08-25T10:50:33.272Z",
"licenseNumber": "text",
"role": "text"
}
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
false
OK
Bad Request
GET /v2/issuers/{idOrEntityId}/badgeclasses HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"id": "68e9d238c5afe622816febb3",
"entityType": "BadgeClass",
"entityId": "iOMWsaF1QbmMCofM54JlUg",
"openBadgeId": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg",
"sourceUrl": "https://example.com/badge-classes/1",
"originalJson": "{}",
"createdAt": "2025-08-25T10:50:33.272Z",
"createdBy": "Hey7J-GRSJeu6FNnHQwNyw",
"issuer": "ZvYydoQhRtOKalNzFPZR2A-Q",
"issuerOpenBadgeId": "https://api.badgr.io/public/issuers/ZvYydoQhRtOKalNzFPZR2A",
"name": "Math Expert",
"image": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image",
"description": "This badge is awarded to students who have demonstrated mastery of Math.",
"achievementType": "Course",
"criteriaUrl": "https://example.com/badge-classes/1/criteria",
"criteriaNarrative": "text",
"alignments": [
{
"targetName": "text",
"targetUrl": "text",
"targetDescription": "text",
"targetFramework": "text",
"targetCode": "text",
"displayAsSkill": true
}
],
"tags": [
"text"
],
"expires": {
"amount": 30,
"duration": "days"
},
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"source": "local",
"imagePath": "uploads/badges/badgeclass-lY1LJ6K4RqG7ThGLYvWNng.png",
"archived": true,
"archivedDate": "2025-08-25T10:50:33.272Z",
"archivalNote": "text",
"ob3Properties": {
"creditHours": 36,
"fieldOfStudy": "Research",
"humanCode": "R1",
"specialization": "Computer Science Research"
},
"preferences": {
"includeOnPublicPages": true,
"customPropertyValues": [
{
"propertyId": "67b32887e2a7a7d5f7adabf1",
"stringValue": "text",
"doubleValue": 1,
"arrayValue": [
"text"
],
"public": true
}
],
"enabledPrintCertTemplateIds": [
"61e9d238c5afe622816febb3"
],
"defaultPrintCertTemplateId": "61e9d238c5afe622816febb3"
}
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
Entity ID of the issuer
ZvYydoQhRtOKalNzFPZR2A-Q
Name of the BadgeClass
Math Expert
Image of the issuer. An URL or a bas64 encoded images.
https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image
The type of achievement
Course
Short description of the BadgeClass
This badge is awarded to students who have demonstrated mastery of Math.
External URL that describes in a human-readable format the criteria for the BadgeClass
https://example.com/badge-classes/1/criteria
Markdown formatted description of the criteria
List of tags that describe the BadgeClass
Created
Bad Request
POST /v2/issuers/{idOrEntityId}/badgeclasses HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1010
{
"issuer": "ZvYydoQhRtOKalNzFPZR2A-Q",
"name": "Math Expert",
"image": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image",
"achievementType": "Course",
"description": "This badge is awarded to students who have demonstrated mastery of Math.",
"criteriaUrl": "https://example.com/badge-classes/1/criteria",
"criteriaNarrative": "text",
"tags": [
"text"
],
"alignments": [
{
"targetName": "text",
"targetUrl": "text",
"targetDescription": "text",
"targetFramework": "text",
"targetCode": "text",
"displayAsSkill": true
}
],
"expires": {
"amount": 30,
"duration": "days"
},
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"ob3Properties": {
"creditHours": 36,
"fieldOfStudy": "Research",
"humanCode": "R1",
"specialization": "Computer Science Research"
},
"preferences": {
"includeOnPublicPages": true,
"customPropertyValues": [
{
"propertyId": "67b32887e2a7a7d5f7adabf1",
"stringValue": "text",
"doubleValue": 1,
"arrayValue": [
"text"
],
"public": true
}
],
"enabledPrintCertTemplateIds": [
"61e9d238c5afe622816febb3"
],
"defaultPrintCertTemplateId": "61e9d238c5afe622816febb3"
}
}
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"id": "68e9d238c5afe622816febb3",
"entityType": "BadgeClass",
"entityId": "iOMWsaF1QbmMCofM54JlUg",
"openBadgeId": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg",
"sourceUrl": "https://example.com/badge-classes/1",
"originalJson": "{}",
"createdAt": "2025-08-25T10:50:33.272Z",
"createdBy": "Hey7J-GRSJeu6FNnHQwNyw",
"issuer": "ZvYydoQhRtOKalNzFPZR2A-Q",
"issuerOpenBadgeId": "https://api.badgr.io/public/issuers/ZvYydoQhRtOKalNzFPZR2A",
"name": "Math Expert",
"image": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image",
"description": "This badge is awarded to students who have demonstrated mastery of Math.",
"achievementType": "Course",
"criteriaUrl": "https://example.com/badge-classes/1/criteria",
"criteriaNarrative": "text",
"alignments": [
{
"targetName": "text",
"targetUrl": "text",
"targetDescription": "text",
"targetFramework": "text",
"targetCode": "text",
"displayAsSkill": true
}
],
"tags": [
"text"
],
"expires": {
"amount": 30,
"duration": "days"
},
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"source": "local",
"imagePath": "uploads/badges/badgeclass-lY1LJ6K4RqG7ThGLYvWNng.png",
"archived": true,
"archivedDate": "2025-08-25T10:50:33.272Z",
"archivalNote": "text",
"ob3Properties": {
"creditHours": 36,
"fieldOfStudy": "Research",
"humanCode": "R1",
"specialization": "Computer Science Research"
},
"preferences": {
"includeOnPublicPages": true,
"customPropertyValues": [
{
"propertyId": "67b32887e2a7a7d5f7adabf1",
"stringValue": "text",
"doubleValue": 1,
"arrayValue": [
"text"
],
"public": true
}
],
"enabledPrintCertTemplateIds": [
"61e9d238c5afe622816febb3"
],
"defaultPrintCertTemplateId": "61e9d238c5afe622816febb3"
}
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
false
OK
Bad Request
GET /v2/badgeclasses HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"id": "68e9d238c5afe622816febb3",
"entityType": "BadgeClass",
"entityId": "iOMWsaF1QbmMCofM54JlUg",
"openBadgeId": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg",
"sourceUrl": "https://example.com/badge-classes/1",
"originalJson": "{}",
"createdAt": "2025-08-25T10:50:33.272Z",
"createdBy": "Hey7J-GRSJeu6FNnHQwNyw",
"issuer": "ZvYydoQhRtOKalNzFPZR2A-Q",
"issuerOpenBadgeId": "https://api.badgr.io/public/issuers/ZvYydoQhRtOKalNzFPZR2A",
"name": "Math Expert",
"image": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image",
"description": "This badge is awarded to students who have demonstrated mastery of Math.",
"achievementType": "Course",
"criteriaUrl": "https://example.com/badge-classes/1/criteria",
"criteriaNarrative": "text",
"alignments": [
{
"targetName": "text",
"targetUrl": "text",
"targetDescription": "text",
"targetFramework": "text",
"targetCode": "text",
"displayAsSkill": true
}
],
"tags": [
"text"
],
"expires": {
"amount": 30,
"duration": "days"
},
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"source": "local",
"imagePath": "uploads/badges/badgeclass-lY1LJ6K4RqG7ThGLYvWNng.png",
"archived": true,
"archivedDate": "2025-08-25T10:50:33.272Z",
"archivalNote": "text",
"ob3Properties": {
"creditHours": 36,
"fieldOfStudy": "Research",
"humanCode": "R1",
"specialization": "Computer Science Research"
},
"preferences": {
"includeOnPublicPages": true,
"customPropertyValues": [
{
"propertyId": "67b32887e2a7a7d5f7adabf1",
"stringValue": "text",
"doubleValue": 1,
"arrayValue": [
"text"
],
"public": true
}
],
"enabledPrintCertTemplateIds": [
"61e9d238c5afe622816febb3"
],
"defaultPrintCertTemplateId": "61e9d238c5afe622816febb3"
}
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
Entity ID of the issuer
ZvYydoQhRtOKalNzFPZR2A-Q
Name of the BadgeClass
Math Expert
Short description of the BadgeClass
This badge is awarded to students who have demonstrated mastery of Math.
Image of the issuer. An URL or a bas64 encoded images.
https://example.com/images/1
The type of achievement
Course
External URL that describes in a human-readable format the criteria for the BadgeClass
https://example.com/badge-classes/1/criteria
Markdown formatted description of the criteria
List of tags that describe the BadgeClass
BadgeClass created
Bad Request
POST /v2/badgeclasses HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 975
{
"issuer": "ZvYydoQhRtOKalNzFPZR2A-Q",
"name": "Math Expert",
"description": "This badge is awarded to students who have demonstrated mastery of Math.",
"image": "https://example.com/images/1",
"achievementType": "Course",
"criteriaUrl": "https://example.com/badge-classes/1/criteria",
"criteriaNarrative": "text",
"tags": [
"text"
],
"alignments": [
{
"targetName": "text",
"targetUrl": "text",
"targetDescription": "text",
"targetFramework": "text",
"targetCode": "text",
"displayAsSkill": true
}
],
"expires": {
"amount": 30,
"duration": "days"
},
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"ob3Properties": {
"creditHours": 36,
"fieldOfStudy": "Research",
"humanCode": "R1",
"specialization": "Computer Science Research"
},
"preferences": {
"includeOnPublicPages": true,
"customPropertyValues": [
{
"propertyId": "67b32887e2a7a7d5f7adabf1",
"stringValue": "text",
"doubleValue": 1,
"arrayValue": [
"text"
],
"public": true
}
],
"enabledPrintCertTemplateIds": [
"61e9d238c5afe622816febb3"
],
"defaultPrintCertTemplateId": "61e9d238c5afe622816febb3"
}
}
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"id": "68e9d238c5afe622816febb3",
"entityType": "BadgeClass",
"entityId": "iOMWsaF1QbmMCofM54JlUg",
"openBadgeId": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg",
"sourceUrl": "https://example.com/badge-classes/1",
"originalJson": "{}",
"createdAt": "2025-08-25T10:50:33.272Z",
"createdBy": "Hey7J-GRSJeu6FNnHQwNyw",
"issuer": "ZvYydoQhRtOKalNzFPZR2A-Q",
"issuerOpenBadgeId": "https://api.badgr.io/public/issuers/ZvYydoQhRtOKalNzFPZR2A",
"name": "Math Expert",
"image": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image",
"description": "This badge is awarded to students who have demonstrated mastery of Math.",
"achievementType": "Course",
"criteriaUrl": "https://example.com/badge-classes/1/criteria",
"criteriaNarrative": "text",
"alignments": [
{
"targetName": "text",
"targetUrl": "text",
"targetDescription": "text",
"targetFramework": "text",
"targetCode": "text",
"displayAsSkill": true
}
],
"tags": [
"text"
],
"expires": {
"amount": 30,
"duration": "days"
},
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"source": "local",
"imagePath": "uploads/badges/badgeclass-lY1LJ6K4RqG7ThGLYvWNng.png",
"archived": true,
"archivedDate": "2025-08-25T10:50:33.272Z",
"archivalNote": "text",
"ob3Properties": {
"creditHours": 36,
"fieldOfStudy": "Research",
"humanCode": "R1",
"specialization": "Computer Science Research"
},
"preferences": {
"includeOnPublicPages": true,
"customPropertyValues": [
{
"propertyId": "67b32887e2a7a7d5f7adabf1",
"stringValue": "text",
"doubleValue": 1,
"arrayValue": [
"text"
],
"public": true
}
],
"enabledPrintCertTemplateIds": [
"61e9d238c5afe622816febb3"
],
"defaultPrintCertTemplateId": "61e9d238c5afe622816febb3"
}
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
Create a duplicate of the original BadgeClass with a new name
The new name for the duplicate badgeclass
Badgeclass Copy
BadgeClass created
Bad Request
POST /v2/badgeclasses/{idOrEntityId}/duplicate HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 29
{
"newName": "Badgeclass Copy"
}
{
"id": "68e9d238c5afe622816febb3",
"entityType": "BadgeClass",
"entityId": "iOMWsaF1QbmMCofM54JlUg",
"openBadgeId": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg",
"sourceUrl": "https://example.com/badge-classes/1",
"originalJson": "{}",
"createdAt": "2025-08-25T10:50:33.272Z",
"createdBy": "Hey7J-GRSJeu6FNnHQwNyw",
"issuer": "ZvYydoQhRtOKalNzFPZR2A-Q",
"issuerOpenBadgeId": "https://api.badgr.io/public/issuers/ZvYydoQhRtOKalNzFPZR2A",
"name": "Math Expert",
"image": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image",
"description": "This badge is awarded to students who have demonstrated mastery of Math.",
"achievementType": "Course",
"criteriaUrl": "https://example.com/badge-classes/1/criteria",
"criteriaNarrative": "text",
"alignments": [
{
"targetName": "text",
"targetUrl": "text",
"targetDescription": "text",
"targetFramework": "text",
"targetCode": "text",
"displayAsSkill": true
}
],
"tags": [
"text"
],
"expires": {
"amount": 30,
"duration": "days"
},
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"source": "local",
"imagePath": "uploads/badges/badgeclass-lY1LJ6K4RqG7ThGLYvWNng.png",
"archived": true,
"archivedDate": "2025-08-25T10:50:33.272Z",
"archivalNote": "text",
"ob3Properties": {
"creditHours": 36,
"fieldOfStudy": "Research",
"humanCode": "R1",
"specialization": "Computer Science Research"
},
"preferences": {
"includeOnPublicPages": true,
"customPropertyValues": [
{
"propertyId": "67b32887e2a7a7d5f7adabf1",
"stringValue": "text",
"doubleValue": 1,
"arrayValue": [
"text"
],
"public": true
}
],
"enabledPrintCertTemplateIds": [
"61e9d238c5afe622816febb3"
],
"defaultPrintCertTemplateId": "61e9d238c5afe622816febb3"
}
}
OK
Bad Request
GET /v2/badgeclasses/{idOrEntityId}/claim-codes HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"code": "5678945",
"createdAt": "2025-08-25T10:50:33.272Z",
"label": "Conference Event",
"limit": 10,
"expirationDate": "2025-08-25T10:50:33.272Z",
"enabled": true,
"claimCount": 1,
"claimUrl": "text"
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
The label of the claim code
Conference Event
The number of times the claim code can be used
10
Created
Bad Request
POST /v2/badgeclasses/{idOrEntityId}/claim-codes HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 83
{
"label": "Conference Event",
"limit": 10,
"expirationDate": "2025-08-25T10:50:33.272Z"
}
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"code": "5678945",
"createdAt": "2025-08-25T10:50:33.272Z",
"label": "Conference Event",
"limit": 10,
"expirationDate": "2025-08-25T10:50:33.272Z",
"enabled": true,
"claimCount": 1,
"claimUrl": "text"
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
Reactivate a BadgeClass that was archived
OK
Bad Request
POST /v2/badgeclasses/reactivate/{idOrEntityId} HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"id": "68e9d238c5afe622816febb3",
"entityType": "BadgeClass",
"entityId": "iOMWsaF1QbmMCofM54JlUg",
"openBadgeId": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg",
"sourceUrl": "https://example.com/badge-classes/1",
"originalJson": "{}",
"createdAt": "2025-08-25T10:50:33.272Z",
"createdBy": "Hey7J-GRSJeu6FNnHQwNyw",
"issuer": "ZvYydoQhRtOKalNzFPZR2A-Q",
"issuerOpenBadgeId": "https://api.badgr.io/public/issuers/ZvYydoQhRtOKalNzFPZR2A",
"name": "Math Expert",
"image": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image",
"description": "This badge is awarded to students who have demonstrated mastery of Math.",
"achievementType": "Course",
"criteriaUrl": "https://example.com/badge-classes/1/criteria",
"criteriaNarrative": "text",
"alignments": [
{
"targetName": "text",
"targetUrl": "text",
"targetDescription": "text",
"targetFramework": "text",
"targetCode": "text",
"displayAsSkill": true
}
],
"tags": [
"text"
],
"expires": {
"amount": 30,
"duration": "days"
},
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"source": "local",
"imagePath": "uploads/badges/badgeclass-lY1LJ6K4RqG7ThGLYvWNng.png",
"archived": true,
"archivedDate": "2025-08-25T10:50:33.272Z",
"archivalNote": "text",
"ob3Properties": {
"creditHours": 36,
"fieldOfStudy": "Research",
"humanCode": "R1",
"specialization": "Computer Science Research"
},
"preferences": {
"includeOnPublicPages": true,
"customPropertyValues": [
{
"propertyId": "67b32887e2a7a7d5f7adabf1",
"stringValue": "text",
"doubleValue": 1,
"arrayValue": [
"text"
],
"public": true
}
],
"enabledPrintCertTemplateIds": [
"61e9d238c5afe622816febb3"
],
"defaultPrintCertTemplateId": "61e9d238c5afe622816febb3"
}
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
Reactivate an archived BadgeClass by its base64 encoded OpenBadge ID
OK
Bad Request
POST /v2/badgeclasses/reactivate/ref/{ref} HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"id": "68e9d238c5afe622816febb3",
"entityType": "BadgeClass",
"entityId": "iOMWsaF1QbmMCofM54JlUg",
"openBadgeId": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg",
"sourceUrl": "https://example.com/badge-classes/1",
"originalJson": "{}",
"createdAt": "2025-08-25T10:50:33.272Z",
"createdBy": "Hey7J-GRSJeu6FNnHQwNyw",
"issuer": "ZvYydoQhRtOKalNzFPZR2A-Q",
"issuerOpenBadgeId": "https://api.badgr.io/public/issuers/ZvYydoQhRtOKalNzFPZR2A",
"name": "Math Expert",
"image": "https://api.badgr.io/public/badges/iOMWsaF1QbmMCofM54JlUg/image",
"description": "This badge is awarded to students who have demonstrated mastery of Math.",
"achievementType": "Course",
"criteriaUrl": "https://example.com/badge-classes/1/criteria",
"criteriaNarrative": "text",
"alignments": [
{
"targetName": "text",
"targetUrl": "text",
"targetDescription": "text",
"targetFramework": "text",
"targetCode": "text",
"displayAsSkill": true
}
],
"tags": [
"text"
],
"expires": {
"amount": 30,
"duration": "days"
},
"extensions": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"source": "local",
"imagePath": "uploads/badges/badgeclass-lY1LJ6K4RqG7ThGLYvWNng.png",
"archived": true,
"archivedDate": "2025-08-25T10:50:33.272Z",
"archivalNote": "text",
"ob3Properties": {
"creditHours": 36,
"fieldOfStudy": "Research",
"humanCode": "R1",
"specialization": "Computer Science Research"
},
"preferences": {
"includeOnPublicPages": true,
"customPropertyValues": [
{
"propertyId": "67b32887e2a7a7d5f7adabf1",
"stringValue": "text",
"doubleValue": 1,
"arrayValue": [
"text"
],
"public": true
}
],
"enabledPrintCertTemplateIds": [
"61e9d238c5afe622816febb3"
],
"defaultPrintCertTemplateId": "61e9d238c5afe622816febb3"
}
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
OK
Bad Request
PATCH /v2/badgeclasses/{idOrEntityId}/claim-codes/{claimCode}/enable HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"code": "5678945",
"createdAt": "2025-08-25T10:50:33.272Z",
"label": "Conference Event",
"limit": 10,
"expirationDate": "2025-08-25T10:50:33.272Z",
"enabled": true,
"claimCount": 1,
"claimUrl": "text"
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
OK
Bad Request
PATCH /v2/badgeclasses/{idOrEntityId}/claim-codes/{claimCode}/disable HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"code": "5678945",
"createdAt": "2025-08-25T10:50:33.272Z",
"label": "Conference Event",
"limit": 10,
"expirationDate": "2025-08-25T10:50:33.272Z",
"enabled": true,
"claimCount": 1,
"claimUrl": "text"
}
],
"timestamp": "2025-08-25T10:50:33.272Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
Last updated
Was this helpful?