Community

Read Community Badges

Changed on Nov 6, 2026

Retrieve an array of badges created by a Community. Optional parameters may be passed to filter the query.

Results can be ordered by name or time_created, either ascending or descending by passing a value into order_by. See below. By default, badges are ordered alphabetically.

Filter	Description
status (string)	A comma separated list of badge statuses. Filter badges by status. If none are provided, all statuses the current user has access to will be returned.
keyword (string)	Get badges with names similar to the provided string.
featured (bool)	Get only featured or unfeatured badges.
qa_locked (bool)	Get only badges that are QA locked (an edit lock: only QA approvers can edit them).
type (Badge_Type)	Get only badges of a certain type. See below for the available types
source (Source_Type)	Get only badges of a certain sort. See below for available sources

Badge_Status:

Initialising, Draft, Awaiting_Approval, Published, Expired, Deleted

Badge_Type:

Generic Types:

    Experience, Learning, Validation, Certification, Attendance, Work_Experience, Volunteering, Job,
    Apprenticeship, Course, Membership, Internship, Workshop, Campaigning, Activism, Other

Navigatr Standard Types:

    Informal_Learning, Training, Certified, Qualification, Membership

Recipient_Type:

User, Organisation

Source_Type:

Internal, Credly

Badge_Order_By:

Time_Created_Asc, Time_Created_Desc, Name_Asc, Name_Desc

get/v1/community/{community_id}/badges

Request

Base URL
https://api.navigatr.app (the document declares no server; this is the origin it was published from)
Auth
OAuth 2
Password
Token URL/v1/token

Path parameters

community_idinteger required

Query parameters

featuredboolean

qa_lockedboolean

recipient_type'User' | 'Organisation'

sourcestring

keywordstring

statusstring

paginatedboolean

pageinteger

sizeinteger

Headers

X-Access-Tokenstring nullable

Response

Successful Response

Example response

{
  "items": [
    {
      "name": "Learn your ABCs",
      "description": "This badge is awarded to earners who have demonstrated their knowledge of all letters of the English alphabet.",
      "image_url": "https://media.navigatr.app/image.webp",
      "image_url_2x": "https://media.navigatr.app/image_2x.webp",
      "address": "123 Example Street, Leeds, West Yorkshire, England, LS1 EXA",
      "availability": "This badge is available to students of the University of Leeds",
      "end_date": "2023-11-18T13:33:01.201Z",
      "qualification_code": "603/1234/5",
      "credits_available": 60,
      "credits_unit": "credits",
      "qualification_level": "3",
      "field_of_study_id": 3,
      "created_by": {
        "firstname": "John",
        "lastname": "Doe",
        "avatar_url": "https://media.navigatr.app/avatar.webp",
        "avatar_url_2x": "https://media.navigatr.app/avatar_2x.webp",
        "avatar_url_original": "https://media.navigatr.app/avatar_original.webp",
        "interests": [
          "Coding, Web Development, Engineering"
        ]
      },
      "submitted_by": {
        "firstname": "John",
        "lastname": "Doe",
        "avatar_url": "https://media.navigatr.app/avatar.webp",
        "avatar_url_2x": "https://media.navigatr.app/avatar_2x.webp",
        "avatar_url_original": "https://media.navigatr.app/avatar_original.webp",
        "interests": [
          "Coding, Web Development, Engineering"
        ]
      },
      "published_by": {
        "firstname": "John",
        "lastname": "Doe",
        "avatar_url": "https://media.navigatr.app/avatar.webp",
        "avatar_url_2x": "https://media.navigatr.app/avatar_2x.webp",
        "avatar_url_original": "https://media.navigatr.app/avatar_original.webp",
        "interests": [
          "Coding, Web Development, Engineering"
        ]
      },
      "updated_by": {
        "firstname": "John",
        "lastname": "Doe",
        "avatar_url": "https://media.navigatr.app/avatar.webp",
        "avatar_url_2x": "https://media.navigatr.app/avatar_2x.webp",
        "avatar_url_original": "https://media.navigatr.app/avatar_original.webp",
        "interests": [
          "Coding, Web Development, Engineering"
        ]
      },
      "criteria": [
        {
          "external_id": "ABCD-EFG-HIJK-LMNOPQRS",
          "description": "Earners must have completed a three stage interview process before they can earn this badge.",
          "external_url": "https://apply.org"
        }
      ],
      "tags": [
        {
          "name": "Test Driven Development"
        }
      ],
      "alignments": [
        {
          "external_id": "123-45678-90",
          "name": "Null Badging Standard - Example Layer",
          "description": "This badge has been mapped to the Example Layer of the Null Badging Standard",
          "url": "https://Null_Badging/Example.org"
        }
      ],
      "endorsements": [
        {
          "external_id": "zyxw-vut-srq-ponmlkjih",
          "name": "Endorsement Example",
          "description": "This is an example of a badge endorsement",
          "url": "https://Endorsement/Example.org",
          "image_url": "https://media.navigatr.app/endorsement.webp",
          "image_url_2x": "https://media.navigatr.app/endorsement_2x.webp",
          "image_url_original": "https://media.navigatr.app/endorsement_original.webp"
        }
      ],
      "providers": [
        {
          "name": "Horace's Haberdashery Academy",
          "short_name": "HHA",
          "community": {
            "name": "Fordwich Town Council",
            "short_name": "FTC",
            "image_url": "https://media.navigatr.app/Fordwich.webp",
            "image_url_2x": "https://media.navigatr.app/Fordwich_2x.webp",
            "image_url_original": "https://media.navigatr.app/Fordwich_original.webp",
            "url": "https://navigatr.app/community/5/fordwich-town-council"
          },
          "image_url": "https://media.navigatr.app/HHA.webp",
          "banner_url": "https://media.navigatr.app/HHA_banner.webp",
          "image_url_2x": "https://media.navigatr.app/HHA_2x.webp",
          "banner_url_2x": "https://media.navigatr.app/HHA_banner_2x.webp",
          "image_url_original": "https://media.navigatr.app/HHA_original.webp",
          "banner_url_original": "https://media.navigatr.app/HHA_banner_original.webp",
          "url": "https://navigatr.app/provider/2922/horaces-haberdashery"
        }
      ],
      "url": "https://navigatr.app/badge/12345/Learn-Your-ABCs"
    }
  ]
}

Changes

Nov 6, 202604bf6727d360 Revision changes
- info
  added the optional property /// to the response with the status
- info
  added the optional property // to the response with the status
Oct 22, 20265b575d75af2b Revision changes
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property // to the response with the status

Operation history (9 revisions)