---
title: "Claim YSWS Program"
method: POST
path: "/api/v1/ysws_programs/claim"
tags: ["YSWS Programs"]
---

# Claim YSWS Program

`POST /api/v1/ysws_programs/claim`

Claim a YSWS program reward.

## Request body

- object
  - `program_id` integer, required — YSWS Program ID
  - `user_id` string, required — User ID or Slack UID
  - `start_time` string, date_time, required — Start time of the claim period
  - `end_time` string, date_time, required — End time of the claim period
  - `project` string, nullable — Project name (optional)

## Response `200`

successful

- object
  - `message` string
  - `claimed_count` integer

## Other responses

- `409` — conflict

## Changes

- **2026-01-27** (v1) `b6d6849481da` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hackclub/apis/hackatime-api/changes/api/v1/ysws_programs/claim/post.md)

---

[API](https://skmtc.dev/hackclub/apis/hackatime-api.md) · [All operations](https://skmtc.dev/hackclub/apis/hackatime-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hackclub/hackatime-api/revisions/b6d6849481da/schema)