API · Six endpoints, one natural-language query

Built for agents to cite, not just consume.

Every response carries the same citation contract as the front-end: custodian, slug, vintage, accessed-at. Strip them and you’re no longer citing Sumber.

Programmatic access is by invitation

Tell us your use case in one line. We respond within two working days.

hello@sumber.io →

GET/v1/series/{slug}

Fetch a single series by slug, with optional vintage.

Returns every observation of the requested series, ordered by period ascending. The vintage parameter pins the result “as of” a given date — most recent revision on or before. Without it, the latest vintage is returned.

Mengembalikan setiap observasi seri yang diminta, diurutkan menurut periode menaik. Parameter vintage mengunci hasil ke “sejak” tanggal tertentu — revisi terbaru pada atau sebelum tanggal itu. Tanpanya, vintage terbaru yang dikembalikan.

Parameter	Type	Description
slugrequired	string · path	Series slug, e.g. `bps.cpi.headline.id.m`.
vintage	YYYY-MM-DD	Return the latest revision dated on or before this date.
from	YYYY-MM-DD	Lower bound on observation period.
to	YYYY-MM-DD	Upper bound on observation period.
lang	en \| id	Lead language for human-readable fields (defaults to en).

REQUEST

curl -H "Authorization: Bearer $SUMBER_KEY" \
  "https://api.sumber.io/v1/series/bps.cpi.headline.id.m?vintage=2026-05-01"

RESPONSE · 200application/json

{
  "slug": "bps.cpi.headline.id.m",
  "title": {
    "en": "CPI headline, year-on-year, monthly",
    "id": "IHK umum, tahun-ke-tahun, bulanan"
  },
  "unit": "percent",
  "frequency": "m",
  "observations": [
    { "period": "2025-01", "value": 2.57 },
    { "period": "2025-02", "value": 2.75 },
    // … more rows
    { "period": "2025-12", "value": 2.41 }
  ],
  "citation": {
    "custodian": "BPS",
    "slug": "bps.cpi.headline.id.m",
    "vintage": "2026-05-01",
    "accessed_at": "2026-05-24T08:14:22Z",
    "licence": "Public, attribution required"
  }
}

GET/v1/search

Full-text search across titles, slugs, and tags.

Returns up to 25 series matching the query, ranked by relevance × freshness. For natural-language questions over data, use /v1/query instead — this endpoint is for cataloguing, not answering.

Mengembalikan hingga 25 seri yang cocok, diurutkan berdasarkan relevansi × kebaruan. Untuk pertanyaan bahasa alami terhadap data, gunakan /v1/query — endpoint ini untuk katalogisasi, bukan untuk menjawab.

Parameter	Type	Description
qrequired	string	Search query, EN or ID.
source	comma-list	Restrict to one or more sources, e.g. `bps,idx`.
domain	comma-list	Restrict to one or more domains.
limit	int, default 25	Max results to return (cap 100).

REQUEST

curl -H "Authorization: Bearer $SUMBER_KEY" \
  "https://api.sumber.io/v1/search?q=inflasi&source=bps"

RESPONSE · 200application/json

{
  "results": [
    {
      "slug": "bps.cpi.headline.id.m",
      "title": "CPI headline, year-on-year",
      "custodian": "BPS",
      "score": 0.94,
      "vintage": "2026-05-01"
    },
    {
      "slug": "bps.cpi.core.id.m",
      "title": "CPI core, year-on-year",
      "custodian": "BPS",
      "score": 0.88,
      "vintage": "2026-05-01"
    }
    // … up to 23 more
  ],
  "total": 8
}

POST/v1/query

Natural-language query against the whole catalogue.

Submit a question in EN or ID. The system picks the most relevant series and returns a structured answer with a chart-ready data slice, a lead sentence in the user’s language, and the full citation. Async polling is part of this endpoint — long-running questions return a token to poll, not a separate endpoint. Every response includes cost.estimated_usd.

Kirim pertanyaan dalam EN atau ID. Sistem memilih seri yang paling relevan dan mengembalikan jawaban terstruktur dengan slice data siap-grafik, kalimat utama dalam bahasa pengguna, dan sitasi lengkap. Polling asinkron adalah bagian dari endpoint ini — pertanyaan panjang mengembalikan token, bukan endpoint terpisah.

REQUEST

curl -X POST -H "Authorization: Bearer $SUMBER_KEY" \
  -H "Content-Type: application/json" \
  "https://api.sumber.io/v1/query" \
  -d '{ "q": "BBCA dividend 2024", "lang": "en" }'

RESPONSE · 200application/json

{
  "question_echo": "BBCA dividend per share, 2020–2024?",
  "stat": { "value": "Rp 270", "label": "final cash dividend per share, FY2024" },
  "lead": "Final cash dividend per share, FY2024, paid March 2025. …",
  "series": {
    "slug": "idx.eqty.bbca.dividend.id.a",
    "observations": [
      { "period": "2020", "value": 205 },
      // …
      { "period": "2024", "value": 270 }
    ]
  },
  "citation": {
    "custodian": "IDX",
    "slug": "idx.eqty.bbca.dividend.id.a",
    "vintage": "2026-03-15"
  },
  "cost": { "estimated_usd": 0.0021 }
}

GET/v1/companies/{ticker}

Listed-company snapshot, with dividend & disclosure feeds.

Returns metadata, the latest 12 months of price + dividend events, and a paginated link to the company’s disclosure feed. Ticker is the 4-letter IDX code (BBCA, BBRI, TLKM).

Mengembalikan metadata, 12 bulan terakhir harga + peristiwa dividen, dan tautan berpaginasi ke umpan keterbukaan perusahaan. Ticker adalah kode IDX 4 huruf (BBCA, BBRI, TLKM).

REQUEST

curl -H "Authorization: Bearer $SUMBER_KEY" \
  "https://api.sumber.io/v1/companies/BBCA"

RESPONSE · 200application/json

{
  "ticker": "BBCA",
  "name": "Bank Central Asia Tbk",
  "sector": "Financials",
  "listed": "2000-05-31",
  "prices_12m": "/v1/series/idx.eqty.bbca.close.id.d",
  "dividends": "/v1/series/idx.eqty.bbca.dividend.id.a",
  "disclosures": "/v1/disclosures?ticker=BBCA",
  "citation": { "custodian": "IDX", "vintage": "2026-05-23" }
}

GET/v1/disclosures

Disclosure feed, filterable by ticker, type, and date.

Returns IDX-style disclosure events (RUPS, dividend, corporate action, material information) ordered by event timestamp descending. Each entry links to the source PDF on idx.co.id.

Mengembalikan peristiwa keterbukaan ala IDX (RUPS, dividen, aksi korporasi, informasi material) diurutkan menurut waktu peristiwa menurun. Tiap entri menautkan ke PDF sumber di idx.co.id.

Parameter	Type	Description
ticker	string	Restrict to a single ticker.
type	enum	One of `rups`, `dividend`, `material`, `action`.
from	YYYY-MM-DD	Lower bound on event date.
limit	int	Max 100, default 25.

GET/v1/regulations/{id}

Regulation lookup, including OJK and BI circulars.

Fetch the metadata and text excerpt of a regulation by its custodian-issued ID (e.g. POJK-17-2023, PBI-23-15-2021). Full text is not redistributed — Sumber links to the custodian’s canonical PDF.

Ambil metadata dan kutipan teks suatu regulasi berdasarkan ID yang diterbitkan penjaga data (mis. POJK-17-2023, PBI-23-15-2021). Teks lengkap tidak diredistribusi — Sumber menautkan ke PDF kanonik penjaga data.

Pricing

Four tiers. The citation contract is in every one.

Free

Public demo + low-volume keys. Rate-limited. Citation contract included.

Developer

$49 / mo

Higher rate limits, all six endpoints, e-mail support.

Pro

$499 / mo

Production volume, priority routing, the Sonnet-class query model.

Enterprise

Custom

Bespoke SLAs, dedicated throughput, custodian-grade support.

Higher volume or commercial use — request a key via hello@sumber.io.