---
title: "Claim badge"
method: POST
path: "/api_gateway/v1/badges/badgeMeta/{badgeId}/claim"
---

# Claim badge

`POST /api_gateway/v1/badges/badgeMeta/{badgeId}/claim`

## Path parameters

- `badgeId` string, required

## Request body

- object
  - `ownerType` 'LOYALTY/REFERRAL_CAMPAIGNS/JOURNEYS/AUDIENCE_CAMPAIGNS/   REWARDS_CATALOG/ GOODWILL_MODULE/ MILESTONES', required — The module for which the badge is being claimed.
  - `referenceId` string, required — A unique identifier associated with the owner.

## Response `200`

200

- union
  - object
    - `data` object
      - `badgeMetaId` unknown
      - `ownerType` string
      - `referenceId` string
    - `errors` unknown
    - `warnings` object[]
      - `code` integer
      - `message` string
  - object
    - `data` object
      - `badgeMetaId` string
      - `ownerType` string
      - `referenceId` string
    - `errors` unknown
    - `warnings` unknown[]
      - unknown

## Other responses

- `400` — 400

---

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