---
title: "Get All Badges for a Specific User"
method: GET
path: "/api/v2/users/{id}/user-badges"
tags: ["User"]
---

# Get All Badges for a Specific User

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

This endpoint retrieves all badges for a specific user. <h3>Required Scope</h3>`badges_users:read`

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer

## Response `200`

Success

- InlineResponse2003
  - `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/versions/4a22b709515c/schema)
