Legal data

Statutes (statutes guide), government name lists, the FSC news feed and standard-form contracts (regulatory guide). The Taiwan judgments routes are described in the statutes guide.

On this page:

• Statutes across the ten statute datasets: GET /v1/legal/statutes/instruments
• One statute with its provisions: GET /v1/legal/statutes/instruments/{instrument_id}
• The provisions of one statute, paged: GET /v1/legal/statutes/instruments/{instrument_id}/provisions
• Entries of a sanctions or exclusion list: GET /v1/legal/regulatory/entries
• One entry of a sanctions or exclusion list: GET /v1/legal/regulatory/entry
• Taiwan FSC news (five RSS feeds): GET /v1/legal/regulatory/fsc_news
• Taiwan standard-form contracts (定型化契約), without text: GET /v1/legal/contracts/tw_standard_forms
• One standard form with its versions and the text of its files: GET /v1/legal/contracts/tw_standard_forms/{form_id}

Statutes across the ten statute datasets#

GET /v1/legal/statutes/instruments

Ordered by instrument_id; the list has no provisions and no foreword. meta.restricted / attribution / licenses carry the terms the data comes with. the statutes guide.

Parameters

Example

curl -s "https://api.aggre.org/v1/legal/statutes/instruments?limit=3" \
  -H "Authorization: Bearer $AGGRE_API_KEY"

Response 200: StatuteInstrumentsResponse.

Errors: 400, 401, 403, 429, 503, in the shared envelope (Errors).

One statute with its provisions#

GET /v1/legal/statutes/instruments/{instrument_id}

At most 5000 provisions; longer ones set provisions_truncated and next_from_seq, continue with the provisions route. A removed instrument still answers 200 with removed_on. Takes no query parameters. the statutes guide.

Parameters

Example

curl -s "https://api.aggre.org/v1/legal/statutes/instruments/<instrument_id>" \
  -H "Authorization: Bearer $AGGRE_API_KEY"

Response 200: StatuteDetailResponse.

Errors: 400, 401, 403, 404, 429, 503, in the shared envelope (Errors).

The provisions of one statute, paged#

GET /v1/legal/statutes/instruments/{instrument_id}/provisions

the statutes guide. A from_seq past the last provision answers 200 with an empty list.

Parameters

Example

curl -s "https://api.aggre.org/v1/legal/statutes/instruments/<instrument_id>/provisions?limit=3" \
  -H "Authorization: Bearer $AGGRE_API_KEY"

Response 200: StatuteProvisionsResponse.

Errors: 400, 401, 403, 404, 429, 503, in the shared envelope (Errors).

Entries of a sanctions or exclusion list#

GET /v1/legal/regulatory/entries

Served as published. the regulatory guide; meta.message carries the terms status.

Parameters

Example

curl -s "https://api.aggre.org/v1/legal/regulatory/entries?dataset=legal.regulatory.ofac_sdn&limit=3" \
  -H "Authorization: Bearer $AGGRE_API_KEY"

Response 200: the envelope { "data": [...], "meta": {...}, "next_cursor": ... } (see Response format); each row of data follows the schema legal_regulatory_entry.

Errors: 400, 401, 403, 429, 503, in the shared envelope (Errors).

One entry of a sanctions or exclusion list#

GET /v1/legal/regulatory/entry

An entry the publisher removed is still found: it carries removed_on.

Parameters

Example

curl -s "https://api.aggre.org/v1/legal/regulatory/entry?dataset=legal.regulatory.ofac_sdn&entry_id=<entry_id>" \
  -H "Authorization: Bearer $AGGRE_API_KEY"

Response 200: the envelope { "data": [...], "meta": {...}, "next_cursor": ... } (see Response format); each row of data follows the schema legal_regulatory_entry.

Errors: 400, 401, 403, 404, 429, 503, in the shared envelope (Errors).

Taiwan FSC news (five RSS feeds)#

GET /v1/legal/regulatory/fsc_news

Items of the Financial Supervisory Commission's five official RSS feeds (press releases, penalty cases, announcements, draft-regulation notices, law interpretations), newest first (undated last), then category, then guid. Titles, links and publication days as published; the plain-text description only with include=text (then limit is at most 100). Not the articles behind the links; items that left a feed are kept; no search in V0. meta.dataset carries the item count and the per-category counts, meta.dataDate the newest publication day, meta.lastReadAt our newest successful run; meta.message says "Terms not read" while nobody has read the FSC's terms. the regulatory guide.

Parameters

Example

curl -s "https://api.aggre.org/v1/legal/regulatory/fsc_news?limit=3" \
  -H "Authorization: Bearer $AGGRE_API_KEY"

Response 200: the envelope { "data": [...], "meta": {...}, "next_cursor": ... } (see Response format); each row of data follows the schema legal_fsc_news_item.

Errors: 400, 401, 403, 429, 503, in the shared envelope (Errors).

Taiwan standard-form contracts (定型化契約), without text#

GET /v1/legal/contracts/tw_standard_forms

Model contracts (範本) and the terms a contract must and must not contain (應記載及不得記載事項), as the worker read them from the Executive Yuan's lists, ordered by form_id. No text and no attachments here: the single-form route has them. q is a literal, case-insensitive title substring. issuer is null on a form whose page named no ministry and matches exactly as stored. A form the publisher stopped listing is left out unless include_removed=true (it carries removed_on). 503 terms_unread until a person has read the publisher's terms. the regulatory guide.

Parameters

Example

curl -s "https://api.aggre.org/v1/legal/contracts/tw_standard_forms?limit=3" \
  -H "Authorization: Bearer $AGGRE_API_KEY"

Response 200: the envelope { "data": [...], "meta": {...}, "next_cursor": ... } (see Response format); each row of data follows the schema legal_contract_form.

Errors: 400, 401, 403, 429, 503, in the shared envelope (Errors).

One standard form with its versions and the text of its files#

GET /v1/legal/contracts/tw_standard_forms/{form_id}

The form, every version (oldest first) and the files of one version with the text extracted from each. version picks an older version (default the current one); text=false leaves the text out. The text is machine-extracted and may contain errors, and a scanned file has none (text_status): file_url is the authoritative document. A removed form is still found (removed_on). 404 for an unknown form or version, 400 for an id that is not a GUID, 503 terms_unread until a person has read the publisher's terms.

Parameters

Example

curl -s "https://api.aggre.org/v1/legal/contracts/tw_standard_forms/<form_id>" \
  -H "Authorization: Bearer $AGGRE_API_KEY"

Response 200: the envelope { "data": [...], "meta": {...}, "next_cursor": ... } (see Response format); each row of data follows the schema legal_contract_form.

Errors: 400, 401, 403, 404, 429, 503, in the shared envelope (Errors).