---
title: "Issue badge (earn)"
method: POST
path: "/api_gateway/v1/badges/customer/earn"
---

# Issue badge (earn)

`POST /api_gateway/v1/badges/customer/earn`

## Request body

- object
  - `badgeMetaId` string
  - `customerId` string, required
  - `requestId` string
  - `triggeredBy` object
  - `ownerType` string, required — Type of owner.
  - `referenceId` string, required — A unique identifier associated with the owner.
  - `earnEventDate` string, date-time — The date on which the customer performed the activity. Earn event date. Timestamp in the ISO 8601 standard format format YYYY-MM-DDTHH:MM:SS.SSSZ. has to be between the badge start date and end date if it is a direct earn type of badge and it has to be between the badge issual start date and end date if it is an issue & earn type of badge.

## Response `200`

200

- object
  - `data` object
    - `badgeMetaId` string
    - `customerId` integer
    - `earnedBadgeId` string
    - `expiresOn` number
    - `requestId` unknown
  - `errors` unknown[]
    - unknown
  - `warnings` unknown[]
    - unknown

## Other responses

- `400` — 400
- `409` — 409

---

[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/versions/de241f2ed9b3/schema)