Company Filings

Returns IDX insider trading filings — buy/sell transactions by company insiders and major shareholders. Supports filtering by sector, subsector, tags, tickers, transaction type, and date range.

Use n for quick top-N retrieval (max 30). For paginated access use page + page_size. The n parameter overrides pagination when set.

GET /v2/filings

Company Filings

cURL

curl --request GET \
  --url https://api.sectors.app/v2/filings/ \
  --header 'Authorization: <api-key>'

200

FilingResponse

[
  {
    "id": 378,
    "created_at": "2025-06-23T09:49:40.099180Z",
    "title": "Dato' Sri Chong Thim Pheng Buys Wilton Makmur Indonesia Tbk",
    "body": "Dato' Sri Chong Thim Pheng, an insider, acquired 2,544,900 shares...",
    "source": "https://www.idx.co.id/...",
    "timestamp": "2025-06-23T16:28:00Z",
    "sector": "basic-materials",
    "sub_sector": "basic-materials",
    "tags": [
      "Bullish",
      "Investment",
      "insider-trading"
    ],
    "tickers": [
      "SQMI.JK"
    ],
    "transaction_type": "buy",
    "holding_before": 3147351329,
    "holding_after": 3152947229,
    "amount_transaction": 5595900,
    "holder_type": "insider",
    "holder_name": "Dato' Sri Chong Thim Pheng",
    "price": "45.6710",
    "transaction_value": "255572700.0000",
    "price_transaction": {
      "prices": [
        43,
        48,
        42
      ],
      "amount_transacted": [
        2544900,
        3000000,
        51000
      ]
    },
    "share_percentage_before": 20.26,
    "share_percentage_after": 20.29,
    "share_percentage_transaction": 0.03,
    "uid": null
  }
]

Authorizations

ApiKeyAuthOAuthBearerAuth

Authorization · string · header · required

API key passed directly in the Authorization header (without Bearer prefix).

Query Parameters

sector · string

Kebab-case sector slug. E.g. healthcare, financials. Get valid values from the Subsectors endpoint.

sub_sector · string

Kebab-case subsector slug. E.g. banks, tobacco. Get valid values from the Subsectors endpoint.

start · string

ISO date (YYYY-MM-DD). Start of the filing timestamp filter range.

end · string

ISO date (YYYY-MM-DD). End of the filing timestamp filter range.

n · integer

Return the latest N filings (max 30). Overrides pagination when set.

page · integer · default: 1

Page number for paginated results.

page_size · integer · default: 20

Number of items per page.

transaction_type · enum<string>

Filter by transaction direction: buy or sell.

Available options: buy, sell

tags · string

Comma-separated tag slugs. E.g. Bullish,insider-trading. Get valid values from the News Tags endpoint.

tickers · string

Comma-separated IDX tickers. E.g. BBCA,BBRI,BMRI.

Response

200

application/json

Array of insider filing records.

{key} · any