---
title: "Get A Specific User Badge"
method: GET
path: "/api/v2/user-badges/{id}"
tags: ["Badges"]
---

# Get A Specific User Badge

`GET /api/v2/user-badges/{id}`

This endpoint retrieves the details of a specific badge that has been awarded to a particular user. <h3>Required Scope</h3>`user_badges:read` or `user_badges:write`

## Path parameters

- `id` string, required

## Response `200`

Success

- InlineResponse2004
  - `data` InlineResponse2003Data
    - `type` string, nullable
    - `id` string, nullable — The id of the badge.
    - `attributes` InlineResponse2003Attributes
      - `title` string — The title of the badge.
      - `url` string — The URL of the badge.
      - `image-url` string — The URL of the badge image to be displayed.
      - `provider` string — The badge issuer.
      - `state` string — The state of the badge. For example, `pending` or `accepted`.
      - `issued-at` string, date-time — When the badge was issued.
      - `expires-at` string, date-time — When the badge expires.
      - `created-at` string, date-time — When the badge was created.
      - `source` string — Who created the badge.
      - `external-id` string — The external identifier provided by badge issuer.
    - `links` SelfLink
      - `self` string
    - `relationships` UserRelationshipsInner[]
      - `user` UserRelationshipsInnerUser
        - `data` UserRelationshipData
          - `id` string, nullable
          - `type` string, nullable

---

[API](https://skmtc.net/degreed/apis/degreed-api-web.md) · [All operations](https://skmtc.net/degreed/apis/degreed-api-web/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/degreed/degreed-api-web/revisions/4a22b709515c/schema)