Public JSON API

BIR issuance data, built to be reused.

Query the source-linked Revenue Regulations, memorandum circulars, orders, and audit issuances that power this index. Build tax research tools, civic projects, and public-interest experiments with read-only access—no API key required during beta.

AccessNo API keyPublic, read-only JSON

CoverageFull indexRR, RMC, RMO, RAO, RDAO, and DOC

Base URL

Use the BetterGov.ph endpoint.

The custom domain is the canonical public origin for API requests.

Live now

BetterGov.ph

https://bir.bettergov.ph/api/v1

Interactive explorer

Try a live search

Requests run against this deployment’s real issuance index.

JSON response

GET /api/v1/search

// Send a request to see the live JSON response.

Ready to request https://bir.bettergov.ph/api/v1/search?q=expanded+withholding+tax&limit=5&kind=rmc.

Quick start

Use it from any HTTP client

Cross-origin GET requests are supported. Successful responses are JSON.

cURL

curl "https://bir.bettergov.ph/api/v1/search?q=expanded+withholding+tax&kind=rmc&limit=5"

JavaScript

const response = await fetch(
  "https://bir.bettergov.ph/api/v1/search?q=expanded+withholding+tax&kind=rmc&limit=5"
);

const data = await response.json();
console.log(data.items);

Reference

Endpoints and parameters

Version 1 is intentionally small, stable, and read-only.

GET/api/v1

Returns the API discovery document, supported issuance kinds, limits, and links.

GET/api/v1/issuances

Lists compact source-linked records. Accepts kind, limit (1–200),sort (newest or oldest), an analysis-backed topic, and the opaque cursor returned by the previous page.

GET/api/v1/search

Searches titles, subjects, and indexed text. q is required (2–500 characters);kind, topic, sort, and limit (1–100) are optional. Relevance is the default search order.

GET/api/v1/issuances/{slug}

Returns one record with indexed full text. Use a canonical slug such as rmc-44-2024 or doc-text-sample.

Existing /api/issuances and /api/search routes remain available for compatibility. New integrations should use /api/v1.

Responsible use

Keep provenance visible.

Verify consequential claims

Extracted text, relevance scores, and summaries are research aids. Check the returned source_url before relying on a provision.

Preserve source links

Each result includes its independent record URL and the BIR source document when available.

Use the service fairly

Cache stable results where appropriate and avoid aggressive polling. Beta access has no SLA.