---
title: "Stock Suspensions"
method: GET
path: "/v2/suspensions/"
tags: ["News & Filings"]
---

# Stock Suspensions

`GET /v2/suspensions/`

Returns a paginated list of historical IDX-listed stock suspensions, including the date a stock was suspended, the official reason, and a link to the IDX PDF notice. Filter by `symbol` to look up a specific company's suspension history, or by `start` / `end` to scope to a date window.

<Note>Date filters: both `start` and `end` are independent and optional — omit either side to leave that bound unconstrained. Future `end` dates return 400.</Note>

<Info>Costs 1 API credit.</Info>

## Query parameters

- `symbol` string
- `start` string
- `end` string
- `limit` integer
- `offset` integer

## Response `200`

Paginated list of stock suspensions.

- IdxSuspensions
  - `results` IdxSuspensionsItem[], required
    - `symbol` string, required — IDX ticker symbol (with `.JK` suffix).
    - `suspension_date` string, date, required — Date the suspension took effect.
    - `reason` string, nullable, required — Official reason for the suspension.
    - `pdf_url` string, nullable, required — Link to the IDX PDF notice for this suspension.
  - `pagination` IdxSuspensionsPagination, required
    - `total_count` integer, required — Total number of matching results.
    - `showing` integer, required — Number of results in this page.
    - `limit` integer, required — Maximum results per page.
    - `offset` integer, required — Number of results skipped.
    - `has_next` boolean, required — Whether a next page exists.
    - `has_previous` boolean, required — Whether a previous page exists.
    - `next_offset` integer, nullable, required — Offset for the next page, or null.
    - `previous_offset` integer, nullable, required — Offset for the previous page, or null.

## Other responses

- `429` — Rate limit exceeded.

---

[API](https://skmtc.dev/sectors/apis/sectors-api.md) · [All operations](https://skmtc.dev/sectors/apis/sectors-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sectors/sectors-api/revisions/49e492f19d77/schema)