Skip to main content
GET
/
v2
/
promotions
/
{enrollment_id}
cURL
curl --request GET \
  --url https://api.zapier.com/v2/promotions/{enrollment_id} \
  --header 'Authorization: Bearer <token>'
{
  "promotion_id": "test_promo",
  "enrollment_date": "2026-04-28T00:00:00Z",
  "expiration_date": "2026-07-26T23:59:59Z",
  "task_limit_per_month": 5,
  "tasks_used_this_month": 0,
  "status": "enrolled"
}

Documentation Index

Fetch the complete documentation index at: https://docs.zapier.com/llms.txt

Use this file to discover all available pages before exploring further.

This API is rate limited.

Authorizations

​
Authorization
string
header
required

The user access token for the user you would like to enroll. See our OAuth2 authentication documentation.

Path Parameters

​
enrollment_id
string
required

Response

Succcessful retrieval of promotion details

Succcessful retrieval of promotion details

​
promotion_id
string
required

The unique identifier for the promotion

​
enrollment_date
string<date-time> | null
required

Date and time of enrollment

​
expiration_date
string<date-time> | null
required

Date and time when the promotion expires

​
task_limit_per_month
integer | null
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