---
title: "List published application seasons"
method: GET
path: "/api/v1/cycles"
tags: ["History"]
---

# List published application seasons

`GET /api/v1/cycles`

## Request

- Base URL: `https://openmedici.com`
- URL: `https://openmedici.com/api/v1/cycles`
- Auth: none required

## Query parameters

- `limit` integer
- `offset` integer
- `upcoming` boolean

## Response `200`

Successful response

- CycleListResponse
  - `data` object[], required
    - `cycle` Cycle, required
      - `id` string, uuid, required
      - `programId` string, uuid, required
      - `label` string, required
      - `opensOn` string, date, nullable, required
      - `deadlineOn` string, date, nullable, required
      - `selectionOn` string, date, nullable, required
      - `decisionOn` string, date, nullable, required
      - `startsOn` string, date, nullable, required
      - `endsOn` string, date, nullable, required
      - `cohortYear` integer, nullable, required
      - `applicationUrl` string, uri, nullable, required
      - `status` 'unknown' | 'upcoming' | 'open' | 'closed' | 'rolling', required
      - `sources` Source[]
        - `id` string, uuid, required
        - `entityType` string, required
        - `entityId` string, uuid, required
        - `kind` string, required
        - `url` string, uri, nullable, required
        - `title` string, nullable, required
        - `publisher` string, nullable, required
        - `publishedOn` string, date, nullable, required
        - `retrievedAt` string, date-time, required
        - `sourceCheckedAt` string, date-time, nullable, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `program` object, required
      - `slug` string, required
      - `name` string, required
  - `meta` ListMeta, required
    - `limit` integer, required
    - `offset` integer, required
    - `count` integer, required

## Other responses

- `4XX`: The request could not be fulfilled because of a client error.

---

[API](https://skmtc.dev/openmedici/apis/open-medici-public-api.md) · [All operations](https://skmtc.dev/openmedici/apis/open-medici-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openmedici/apis/open-medici-public-api/revisions/3b7a349ded21?raw)