Skip to main content

List Seasons

GET 

/api/v2/seasons

Paginated seasons with the number of products linked to each.

Required scope: products:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

There is no refresh or recompute parameter: season statuses are recalculated from their dates once a day, and on every create or update when no status is sent. A season whose status was set by hand (status_manual true) keeps it.

Filters, sorts and pagination are listed in the query parameters.

Response fields: Season fields: id, code (short code such as SS26), name, starts_on and ends_on (Y-m-d dates or null), status (planned, selling or ended), status_manual (true when the status was picked by hand and no longer follows the dates), sort_order, created_at, updated_at (ISO 8601). Each row also carries products_count.

Requires a Bearer token with the products read/write scope and the products.show permission.

Request​

Responses​

OK

Response Headers
    Content-Type