Assign a Badge
Assign a Badge to a single Earner
Assigns a badge to an Earner based on the specified badge template selected including the details about the activities completed, validity and additional notes.
- POST
/api/v1/issuers/organization/badges
{
"recipient_email": "mark.br@",
"recipient_first_name": "Mark",
"recipient_last_name": "Bright",
"emitted_at": "2024-06-20 16:00:00",
"expires_at": "2026-07-06 20:00:00",
"activity_title": "Full Course 01-06",
"activity_started_at": "2024-01-10",
"activity_ended_at": "2024-06-01",
"notes": "An online course",
"badge_template_id": "05a72edc-52e1-418c-ada2-ee58cf879d92"
}
{
"data": {
"id": "907ea56d-be8a-4021-a9ff-e9ec92ded842",
"imported": 0,
"status": "valid",
"image_path": "https://storage.googleapis.com/openbadge-public/open-badges-dev/assets/default_badge.png",
"image_high_path": "https://storage.googleapis.com/openbadge-public/open-badges-dev/assets/default_badge.png",
"image_thumbnail_path": "https://storage.googleapis.com/openbadge-public/open-badges-dev/assets/default_badge.png",
"badge_template_version_id": "d6997aa1-91e8-454d-b943-7229a5cdecd9",
"badge_template_version": {
"id": "d6997aa1-91e8-454d-b943-7229a5cdecd9",
"organization_id": "0f11feda-07f8-4202-9133-4a4e780e857d",
"title": "Marketing Presentation Fundamentals",
"assignment_criteria": "<p><strong>Presentation Development</strong>: Students will create a marketing presentation on a selected product or service, including research, content creation, and visual design.</p><p><strong>Delivery Practic</strong>e: Each student will practice and deliver their presentation to the class, demonstrating their understanding of presentation techniques and audience engagement.</p><p>Peer Review: Students will provide constructive feedback to their peers, focusing on content, design, and delivery.</p><p>Final Project: A polished, professional marketing presentation, incorporating peer feedback and demonstrating mastery of course concepts.</p>",
"image_path": "https://storage.googleapis.com/openbadge-public/open-badges-dev/badge-templates-images/CI6yqQQMHSDvmwFB5mCjhIC2hnTaD6Ie9hdc3otI.png",
"image_high_path": "https://storage.googleapis.com/openbadge-public/open-badges-dev/badge-templates-images/CI6yqQQMHSDvmwFB5mCjhIC2hnTaD6Ie9hdc3otI_high.png",
"image_thumbnail_path": "https://storage.googleapis.com/openbadge-public/open-badges-dev/badge-templates-images/CI6yqQQMHSDvmwFB5mCjhIC2hnTaD6Ie9hdc3otI_thumbnail.png",
"background_image_path": "https://storage.googleapis.com/openbadge-public/open-badges-dev/badge-templates-background-images/KIfGgvD1QN2qrNQLDVJVtZkA1yG1K0pGXUxCwUXg.jpg",
"background_image_high_path": "https://storage.googleapis.com/openbadge-public/open-badges-dev/badge-templates-background-images/Oy1FXS9STzHnVeVLMVAvbtgQ8lrt34k6iottpF8b.jpg",
"background_image_thumbnail_path": "https://storage.googleapis.com/openbadge-public/open-badges-dev/badge-templates-background-images/Oy1FXS9STzHnVeVLMVAvbtgQ8lrt34k6iottpF8b.jpg",
"color_primary": "#CC2525",
"code": "MKTG2024",
"type": "skills",
"type_data": {
"acquired_skills": "<td style=\"border-bottom:1px solid black; width:162px; padding:0cm 7px 0cm 7px; border-top:1px solid black; border-right:1px solid black; border-left:1px solid black\" valign=\"top\">\n\t\t\t<p style=\"border:none\"><span style=\"font-size:12pt\"><span style=\"font-family:"News Serif"\"><span style=\"font-family:"Times New Roman","serif"\"><span style=\"color:black\">Orientamento al business</span></span></span></span></p>\n\t\t\t</td>",
"acquired_attitudes": "<ol><li>Understanding of marketing principles and how they apply to presentations.</li><li>Techniques for audience analysis and targeting.</li><li>Best practices for designing visually appealing and effective slides.</li><li>Strategies for structuring presentations to maximize impact.</li><li>Insights into persuasive communication and storytelling in a marketing context.</li></ol>",
"acquired_knowledge": "<ol><li>Understanding of marketing principles and how they apply to presentations.</li><li>Techniques for audience analysis and targeting.</li><li>Best practices for designing visually appealing and effective slides.</li><li>Strategies for structuring presentations to maximize impact.</li><li>Insights into persuasive communication and storytelling in a marketing context.</li></ol>"
},
"description": "<p><strong>Presentation Development</strong>: Students will create a marketing presentation on a selected product or service, including research, content creation, and visual design.</p><p><strong>Delivery Practic</strong>e: Each student will practice and deliver their presentation to the class, demonstrating their understanding of presentation techniques and audience engagement.</p><p>Peer Review: Students will provide constructive feedback to their peers, focusing on content, design, and delivery.</p><p>Final Project: A polished, professional marketing presentation, incorporating peer feedback and demonstrating mastery of course concepts.</p>",
"other_org": "IBM",
"other_org_info": "Course CCNA",
"learn_more_url": null,
"language": "it",
"is_learning_path": null,
"version_code": "2",
"badge_template_id": "05a72edc-52e1-418c-ada2-ee58cf879d92",
"created_at": "2024-10-01T10:24:07.000000Z",
"updated_at": "2024-10-01T10:24:07.000000Z",
"organization": {
"id": "0f11feda-07f8-4202-9133-4a4e780e857d",
"type": "public_local_national",
"activity": "school",
"name": "LearnQuest Academy",
"description": "<p><em>Welcome to </em><strong>LearnQuest Academy</strong><em>, where education meets innovation! At LearnQuest, we offer a diverse array of courses designed to expand your knowledge and skills across various topics. Upon successful completion of each course, students earn distinctive badges, showcasing their achievements and expertise. Whether you're delving into technology, arts, sciences, or personal development, our engaging curriculum and dedicated instructors ensure a comprehensive learning experience. Join us at LearnQuest Academy and start earning your badges today!!!</em></p>",
"address_info": {
"city": "Example City",
"state": "Example State",
"region": "Example Region",
"street": "123 Example Street",
"country": "Example Country",
"postcode": "12345"
},
"billing_info": {
"vat": "VAT123456",
"email": "billing@open-badge.eu",
"code_dest": "CODE123",
"fiscal_code": "FISCAL123",
"certified_email": "certified@open-badge.eu",
"legal_name": "LearnQuest Academy s.r.l."
},
"language": "it",
"website": "https://www.example.com",
"status": "enabled",
"contact_info": {
"name": "John",
"email": "contact@open-badge.eu",
"mobile": "+001234567890",
"last_name": "Doe",
"tech_email": "tech@open-badge.eu",
"legal_email": "legal@open-badge.eu"
},
"settings": {
"public_profile": 1,
"public_badge_types": 1,
"public_learning_paths": 0,
"public_badge_templates": 1
},
"logo_path": "https://storage.googleapis.com/openbadge-public/open-badges-dev/organizations/0f11feda-07f8-4202-9133-4a4e780e857d/organization-logos/9hpYVtMrcEa2sSXAy20KQxGESXQBdAp5pKlRdjx6.png",
"logo_high_path": "https://storage.googleapis.com/openbadge-public/open-badges-dev/organizations/0f11feda-07f8-4202-9133-4a4e780e857d/organization-logos/9hpYVtMrcEa2sSXAy20KQxGESXQBdAp5pKlRdjx6_high.png",
"logo_thumbnail_path": "https://storage.googleapis.com/openbadge-public/open-badges-dev/organizations/0f11feda-07f8-4202-9133-4a4e780e857d/organization-logos/9hpYVtMrcEa2sSXAy20KQxGESXQBdAp5pKlRdjx6_thumbnail.png",
"credits_left": 39804,
"badge_templates_count": 29,
"badges_count": 255,
"created_at": "2024-07-03T15:02:45.000000Z",
"updated_at": "2024-09-27T15:26:27.000000Z",
"public_url": "https://openbadges.open-badge.eu/public/issuers/0f11feda-07f8-4202-9133-4a4e780e857d",
"stripe_customer_id": "cus_QpT1CW2JIJb9fL",
"subscription_id": null,
"subscription_status": "active",
"current_period_start": "2024-09-24 07:53:39",
"current_period_end": "2024-10-24 07:53:39",
"max_users": 1
}
},
"organization_id": "0f11feda-07f8-4202-9133-4a4e780e857d",
"activity_title": "Full Course 01-06",
"recipient_email": "mark.b@open-badge.eu",
"recipient_first_name": "Mark",
"recipient_last_name": "Bright",
"notes": "An online course",
"additional_details": null,
"url": "https://openbadges.open-badge.eu/public/badges/907ea56d-be8a-4021-a9ff-e9ec92ded842",
"user": null,
"emitted_at": "2024-06-20 00:00:00",
"expires_at": "2026-06-06 00:00:00",
"created_at": "2024-10-01T10:34:41.000000Z",
"updated_at": "2024-10-01T10:34:41.000000Z",
"revoked_at": null,
"revoked_reason": null,
}
}
Assign a badge to the list of Earners (bulk assignation)
Assigns the badge template to the selected list of Earners.
- POST
/api/v1/issuers/organization/badges/earners-lists/{earners_list_id}
{
"emitted_at": "2024-06-20 16:00:00",
"expires_at": "2024-06-27 20:00:00",
"activity_title": "Dog Course 02-06",
"activity_started_at": "2024-01-10",
"activity_ended_at": "2024-06-01",
"notes": "great students",
"badge_template_id": "05a72edc-52e1-418c-ada2-ee58cf879d92"
}
{
"message": "Badge has been assigned to the earners list successfully."
}
Read more about Earners list.
Last modified: 12 November 2024