Badgeclasses
false
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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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
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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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.
DELETE /v2/badgeclasses/{idOrEntityId} HTTP/1.1
Host: api.badgr.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"status": {
"success": true,
"description": "ok"
},
"timestamp": "2025-07-05T01:42:11.497Z",
"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
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-07-05T01:42:11.497Z"
}
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"code": "5678945",
"createdAt": "2025-07-05T01:42:11.497Z",
"label": "Conference Event",
"limit": 10,
"expirationDate": "2025-07-05T01:42:11.497Z",
"enabled": true,
"claimCount": 1,
"claimUrl": "text"
}
],
"timestamp": "2025-07-05T01:42:11.497Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
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-07-05T01:42:11.497Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
false
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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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
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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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.
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-07-05T01:42:11.497Z",
"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
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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"activityEnd": "2025-07-05T01:42:11.497Z",
"licenseNumber": "text",
"role": "text"
}
}
],
"timestamp": "2025-07-05T01:42:11.497Z",
"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
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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"ob3AwardProperties": {
"activityStart": "2025-07-05T01:42:11.497Z",
"activityEnd": "2025-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"activityEnd": "2025-07-05T01:42:11.497Z",
"licenseNumber": "text",
"role": "text"
}
}
],
"timestamp": "2025-07-05T01:42:11.497Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
false
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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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
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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
false
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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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
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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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
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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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"
}
}
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-07-05T01:42:11.497Z",
"label": "Conference Event",
"limit": 10,
"expirationDate": "2025-07-05T01:42:11.497Z",
"enabled": true,
"claimCount": 1,
"claimUrl": "text"
}
],
"timestamp": "2025-07-05T01:42:11.497Z",
"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
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-07-05T01:42:11.497Z"
}
{
"status": {
"success": true,
"description": "ok"
},
"result": [
{
"code": "5678945",
"createdAt": "2025-07-05T01:42:11.497Z",
"label": "Conference Event",
"limit": 10,
"expirationDate": "2025-07-05T01:42:11.497Z",
"enabled": true,
"claimCount": 1,
"claimUrl": "text"
}
],
"timestamp": "2025-07-05T01:42:11.497Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
Reactivate a BadgeClass that was archived
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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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
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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"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-07-05T01:42:11.497Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
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-07-05T01:42:11.497Z",
"label": "Conference Event",
"limit": 10,
"expirationDate": "2025-07-05T01:42:11.497Z",
"enabled": true,
"claimCount": 1,
"claimUrl": "text"
}
],
"timestamp": "2025-07-05T01:42:11.497Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
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-07-05T01:42:11.497Z",
"label": "Conference Event",
"limit": 10,
"expirationDate": "2025-07-05T01:42:11.497Z",
"enabled": true,
"claimCount": 1,
"claimUrl": "text"
}
],
"timestamp": "2025-07-05T01:42:11.497Z",
"validationErrors": [
"text"
],
"nonFieldErrors": [
"text"
],
"fieldErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"errorCode": "text",
"warnings": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"latestTermsVersion": 1
}
Last updated
Was this helpful?