List subscription items

Retrieve all line items for a specific subscription. Items represent individual products/prices within a multi-product subscription.

Related endpoints

• POST /subscriptions — Create a new subscription
• GET /subscriptions — List subscriptions
• GET /subscriptions/{id} — Get subscription by ID
• PATCH /subscriptions/{id} — Update subscription details
• DELETE /subscriptions/{id} — Delete subscription
• POST /subscriptions/{id}/change-plan — Change subscription plan
• POST /subscriptions/{id}/change-quantity — Change subscription quantity
• POST /subscriptions/{id}/preview-renewal — Preview subscription renewal

Common errors

• 401 unauthenticated — missing, malformed, or revoked API key.
• 404 resource_missing — the referenced resource does not exist or is not visible to your key.

Pagination

Offset-based with limit (default 25, max 100) and offset. The response pagination block includes total and hasMore. See the pagination guide for SDK auto-paging helpers.

curl "https://api.revkeen.com/v2/subscriptions/00000000-0000-0000-0000-000000000000/items" \  -H "x-api-key: $REVKEEN_API_KEY"

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "subscription_id": "660e8400-e29b-41d4-a716-446655440000",
      "product_id": "770e8400-e29b-41d4-a716-446655440000",
      "price_id": "880e8400-e29b-41d4-a716-446655440000",
      "description": "Pro Plan - Monthly",
      "quantity": 1,
      "currency": "USD",
      "unit_amount_minor": 2999,
      "fulfillment_type": "none",
      "metadata": {
        "property1": null,
        "property2": null
      },
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ],
  "meta": {
    "total": 10,
    "limit": 100,
    "offset": 0,
    "has_more": false
  }
}