---
title: "POST /api/public/purchases/{purchaseId}/credits"
method: POST
path: "/api/public/purchases/{purchaseId}/credits"
tags: ["Purchases"]
---

# POST /api/public/purchases/{purchaseId}/credits

`POST /api/public/purchases/{purchaseId}/credits`

## Request

- Base URL: `https://api.coach-platform.com`
- URL: `https://api.coach-platform.com/api/public/purchases/{purchaseId}/credits`
- Auth: HTTP bearer

Add credits to a punch card purchase. An EXPIRED punch card that ran out of credits becomes ACTIVE again. Punch cards only.

## Path parameters

- `purchaseId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `amount` number, required: Credits to add
  - `note` string: Note stored on the purchase history

## Response `200`

Successful response

- object: Successful response
  - `data` object
    - `id` string
    - `coachId` string
    - `traineeId` string
    - `productId` string
    - `purchaseDate` string, date-time
    - `expirationDate` string, date-time
    - `purchaseAmount` number
    - `currency` 'ILS' | 'USD' | 'EUR' | 'GBP'
    - `status` 'ACTIVE' | 'EXPIRED' | 'CANCELLED' | 'PENDING' | 'WAITING_FOR_PAYMENT'
    - `initialCredits` number
    - `remainingCredits` number
    - `membershipStartDate` string, date-time
    - `membershipEndDate` string, date-time
    - `currentPeriodUsages` number
    - `periodResetDate` string, date-time
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `409`: Default Response
- `429`: Default Response
- `500`: Default Response

## Changes

- **2026-11-01** `c75a8bd18dee`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/coach-platform/apis/coach-platform-api/changes/api/public/purchases/:purchaseId/credits/post.md)

---

[API](https://skmtc.dev/coach-platform/apis/coach-platform-api.md) - [All operations](https://skmtc.dev/coach-platform/apis/coach-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coach-platform/apis/coach-platform-api/revisions/c75a8bd18dee?raw)
