---
title: "POST /incentive/enroll"
method: POST
path: "/incentive/enroll"
tags: ["incentive"]
---

# POST /incentive/enroll

`POST /incentive/enroll`

## Request

- Base URL: `https://swap-backend.stage.defi.ovh.gala.com`
- URL: `https://swap-backend.stage.defi.ovh.gala.com/incentive/enroll`
- Auth: none declared
- TypeScript: <https://skmtc.dev/gala/apis/gala-defi-backend-api/docs/incentive/enroll/post.ts> (a function with typed inputs; its response is checked against the schema)

POST /incentive/enroll

## Request body

- EnrollPositionDto
  - `programId` number, required: Incentive program identifier.
  - `walletAddress` string, required: Synthetic or caller wallet reference that owns the position.
  - `tickLower` number, required: Lower tick bound of the enrolled position.
  - `tickUpper` number, required: Upper tick bound of the enrolled position.
  - `termsAcceptedTxHash` string: Transaction hash proving acceptance of program terms.

## Response `200`

- IncentiveProgramPositionResponseDto
  - `id` number, required
  - `programId` number, required
  - `walletAddress` string, required
  - `owner` string, nullable, required
  - `positionId` string, required
  - `tickLower` number, nullable, required
  - `tickUpper` number, nullable, required
  - `initialLiquidity` string, required
  - `initialValueUsd` number, nullable, required
  - `isFullRange` boolean, required
  - `isQualified` boolean, required
  - `enrolledAt` string, date-time, required
  - `disqualifiedAt` string, date-time, nullable, required
  - `disqualificationReason` string, nullable, required
  - `termsAcceptedAt` string, date-time, nullable, required
  - `termsAcceptedIp` string, nullable, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`
- `404`
- `default`: An error response using the shared backend error envelope.

---

[API](https://skmtc.dev/gala/apis/gala-defi-backend-api.md) - [All operations](https://skmtc.dev/gala/apis/gala-defi-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gala/apis/gala-defi-backend-api/revisions/84f8184e2828?raw)