---
title: "Retrieve the current, previous, and next period ids and date ranges"
method: GET
path: "/api/v1/periods"
tags: ["general"]
---

# Retrieve the current, previous, and next period ids and date ranges

`GET /api/v1/periods`

## Query parameters

- `access_key` string — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.

## Response `200`

Successful

- ViewPeriodsResponse
  - `periods` RegionPeriod[], required — Period information for each region
    - `region` string, required — Region slug
    - `previous` Period, required
      - `period` integer, required — Period ID
      - `start` string, required — Period start date (ISO 8601)
      - `end` string, required — Period end date (ISO 8601)
    - `current` Period, required
      - `period` integer, required — Period ID
      - `start` string, required — Period start date (ISO 8601)
      - `end` string, required — Period end date (ISO 8601)
    - `next` Period, required
      - `period` integer, required — Period ID
      - `start` string, required — Period start date (ISO 8601)
      - `end` string, required — Period end date (ISO 8601)

---

[API](https://skmtc.net/raider/apis/raider-io-developer-api.md) · [All operations](https://skmtc.net/raider/apis/raider-io-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/raider/raider-io-developer-api/versions/4c612ac925bb/schema)