Developers
Enrollments

List a user's enrollments

GET/users/{user_id}/enrollments

Lists the user's enrollments, one per delivery.

When the credentials are restricted to specific products, only enrollments for deliveries that include at least one of those products are returned. Revoked enrollments are excluded unless status=revoked or deleted=true is supplied.

Authorization

AuthorizationBearer <token>

Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.

In: header

Path Parameters

user_id*string

Query Parameters

limit?integer
Range1 <= value <= 200
cursor?string
product_id?string
delivery_id?string
status?string

Value in

  • "active"
  • "suspended"
  • "revoked"
origin?string

Value in

  • "manual"
  • "sale"
  • "subscription"
deleted?boolean
updated_after?string
Formatdate-time

Header Parameters

X-Client-Request-Id?string

Optional client-generated identifier of the request, up to 64 characters from [A-Za-z0-9._-]. Echoed back in the response and recorded in the request log; it never replaces the server-generated X-Request-Id.

Lengthlength <= 64

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/users/string/enrollments"
{  "data": [    {      "created_at": "2019-08-24T14:15:22Z",      "deleted": true,      "delivery_id": "string",      "ends_at": "2019-08-24T14:15:22Z",      "id": "string",      "object": "enrollment",      "origin": {        "kind": "manual",        "sale_id": "string",        "subscription_id": "string"      },      "product_ids": [        "string"      ],      "revision": "string",      "status": "active",      "subscription_ends_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "user_id": "string"    }  ]}

List enrollments GET

Lists enrollments across all users in the account. At least one of `user_id`, `product_id`, `delivery_id`, or `updated_after` must be supplied; requests without any of these filters are rejected with a validation error. When the credentials are restricted to specific products or users, only enrollments within that scope are returned. Revoked enrollments are excluded unless `status=revoked` or `deleted=true` is supplied. Each item includes a `links.self` URL pointing to the enrollment under its user.

Create an enrollment POST

Grants the user access to a delivery. The `Idempotency-Key` header is required. If the user already has an enrollment for the same delivery, the existing enrollment is reactivated and returned with `200 OK` instead of creating a new one. The credentials must have access to every product included in the delivery. A delivery that does not exist, is archived, has no products, or includes products outside the scope of the current credentials is rejected with a validation error on `delivery_id`.