---
title: "GET /v2/promotions/{enrollment_id}"
method: GET
path: "/v2/promotions/{enrollment_id}"
tags: ["Promotions", "Experimental"]
---

# GET /v2/promotions/{enrollment_id}

`GET /v2/promotions/{enrollment_id}`

Retrieve promotion enrollment details by enrollment ID.

Endpoint available to Partners only.
The request must be authenticated by a user access token
that the user has granted to the Partner for the account.

#### OAuth

This endpoint requires the `promotions:read` OAuth scope.

## Path parameters

- `enrollment_id` string, required

## Response `200`

Succcessful retrieval of promotion details

- PromotionDetail — Succcessful retrieval of promotion details
  - `promotion_id` string, required — The unique identifier for the promotion
  - `enrollment_date` string, date-time, nullable, required — Date and time of enrollment
  - `expiration_date` string, date-time, nullable, required — Date and time when the promotion expires
  - `task_limit_per_month` integer, nullable, required — Maximum number of tasks allowed per monthly billing cycle
  - `tasks_used_this_month` integer, required — Number of tasks already used this monthly billing cycle (may not align with calendar month)
  - `status` string, required — Current status of the enrollment

## Other responses

- `401` — Access denied: User does not have permission for enrollment_id: enroll_67890
- `403` — Forbidden - User lacks permission to access this location
- `404` — No response body
- `429`
- `503`

---

[API](https://skmtc.dev/zapier/apis/trigger-inbox-api.md) · [All operations](https://skmtc.dev/zapier/apis/trigger-inbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zapier/trigger-inbox-api/revisions/3fc4c2846ba1/schema)