Pass Windows

List a project's pass windows

curl "https://api.subscriby.net/v1/projects/$PROJECT_ID/pass-windows?status=scheduled&sellable_only=true" \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

The project's windows across every pass plan, soonest first, 50 per page (per_page 1 to 100; limit is accepted as an alias). Filters are validated before they reach the query: an unknown status or a malformed date is a 422 VALIDATION_FAILED naming the field, not an empty page.

The list also opens to project-subscription-plan:view-any. The list shipped under the plan ability before the pass-window:* family had any surface, and it is what the n8n node and the MCP tool docs named. A token holding only project-subscription-plan:view-any therefore still satisfies the pass-window:view-any gate. Mint new tokens with the precise ability; the alias exists so old ones keep working.

get/v1/projects/{project}/pass-windows

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/projects/{project}/pass-windows
  • Auth: HTTP bearer

Path parameters

projectstring uuid required

The project, resolved by the route binder.

Query parameters

plan_idstring uuid nullable

One pass plan of the project only.

status'scheduled' | 'open' | 'closed' | 'canceled'

One state only: scheduled, open, closed or canceled. Anything else is refused.

fromstring date-time nullable

Only windows starting at or after this moment, ISO 8601.

tostring date-time nullable

Only windows starting at or before this moment, ISO 8601.

sellable_onlyboolean

Keep only windows a buyer could still purchase.

pageinteger

The 1-based page to return. A page past the last answers an empty data array with meta.total still filled, so a loop can stop without guessing.

per_pageinteger

Rows per page, 1 to 100. A higher value clamps to the cap silently. Defaults to 50.

sort_bystring

The column to order by. Defaults to created_at; a column the endpoint does not offer falls back to the default rather than failing.

sort_direction'asc' | 'desc'

asc or desc. Defaults to desc.

limitinteger

Legacy alias of per_page, kept for clients that predate it. per_page wins when both are sent.

Response

The page, soonest first.

Example response

{
  "data": [
    {
      "id": "3d5a8c72-b016-4e94-8fa7-61c209d4e738",
      "plan_id": "c4e82f16-93a7-4d5b-b81c-6e0f27a94d3b",
      "plan_name": "Match Day Pass",
      "starts_at": "2026-09-20T13:00:00+00:00",
      "ends_at": "2026-09-20T16:00:00+00:00",
      "timezone": "America/New_York",
      "local_range": "Sun 20 Sep 2026, 09:00 – 12:00 EDT",
      "duration_minutes": 180,
      "status": "scheduled",
      "source": "generated",
      "sellable": true,
      "holders": 38
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.