curl -X GET https://api.metrifox.com/api/v1/product_catalogues/promotional-entitlements/625f5cee-259b-4994-b7eb-416b9e551f2c \
  -H "x-api-key: your_api_key"

{
  "statusCode": 200,
  "message": "Promotional entitlement fetched",
  "meta": {},
  "data": {
    "id": "625f5cee-259b-4994-b7eb-416b9e551f2c",
    "name": "Summer Campaign Boost",
    "description": "Extra API calls for the summer promotion",
    "mode": "additive",
    "included_allowance": 1000,
    "included_allowance_reset_interval": "monthly",
    "included_allowance_reset_anchor": null,
    "starts_at": "2026-06-01T00:00:00Z",
    "expires_at": "2026-09-01T00:00:00Z",
    "duration_value": 3,
    "duration_unit": "month",
    "status": "active",
    "is_applied": true,
    "feature_id": "9c1f1d2e-0000-0000-0000-000000000010",
    "feature_name": "API Calls",
    "feature_type": "metered",
    "created_at": "2026-05-20T10:00:00Z",
    "updated_at": "2026-05-20T10:00:00Z"
  },
  "errors": {}
}