⌕

Tài liệu tham khảo API

Legal Documents & Search

GET/v1/legal/documents

List / filter legal documents

Param	In	Required
doc_type	query	no
agency	query	no
field	query	no
eff_status	query	no
issued_from	query	no
issued_to	query	no
effective_from	query	no
effective_to	query	no
q	query	no
sort	query	no
cursor	query	no
limit	query	no

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/v1/legal/documents/{ref}

Get a single document

Param	In	Required
ref	path	yes
include	query	no
at	query	no

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/v1/legal/documents/{ref}/units

Get a document's units

Param	In	Required
ref	path	yes
revision	query	no

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/v1/legal/documents/{ref}/effectivity

Get a document's effectivity timeline

Param	In	Required
ref	path	yes
at	query	no

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/v1/legal/documents/{ref}/relations

Get a document's relation graph

Param	In	Required
ref	path	yes
direction	query	no
types	query	no

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/v1/legal/search

Search legal units (full-text, semantic, or hybrid)

Param	In	Required
q	query	yes
mode	query	no
doc_type	query	no
field	query	no
eff_status	query	no
limit	query	no

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/v1/legal/changes

Change-event feed

Param	In	Required
since	query	yes
types	query	no
subtypes	query	no
doc_type	query	no
field	query	no
limit	query	no

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/v1/legal/export

Bulk export (NDJSON)

Param	In	Required
doc_type	query	no
field	query	no

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

Public Procurement & Bidding

GET/v1/bidding/packages

List / filter bidding packages

Param	In	Required
q	query	no
category	query	no
selection_method	query	no
notice_type	query	no
province_code	query	no
investor	query	no
min_budget	query	no
max_budget	query	no
status	query	no
closing_after	query	no
sort	query	no
cursor	query	no
limit	query	no

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/v1/bidding/packages/{tbmt_code}

Get a single bidding package

Param	In	Required
tbmt_code	path	yes
include	query	no

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/v1/bidding/packages/{tbmt_code}/history

Get revision and change-event history for a bidding package

Param	In	Required
tbmt_code	path	yes

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/v1/bidding/investors

Aggregate investor and winning bidder statistics

Param	In	Required
q	query	no
province_code	query	no
role	query	no
limit	query	no

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/v1/bidding/search

Search bidding units (GET query params — FTS, semantic, or hybrid)

Param	In	Required
q	query	yes
mode	query	no
category	query	no
province_code	query	no
status	query	no
min_budget	query	no
max_budget	query	no
limit	query	no

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

POST/v1/bidding/search

Search bidding units (POST JSON body — FTS, semantic, or hybrid)

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

Account & Usage

GET/v1/usage

Current-period usage

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/v1/me

Caller identity

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

Webhooks & Event Delivery

GET/v1/webhooks

List webhook subscriptions

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

POST/v1/webhooks

Create a webhook subscription

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

DELETE/v1/webhooks/{subscription_id}

Delete a webhook subscription

Param	In	Required
subscription_id	path	yes

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

POST/v1/webhooks/{subscription_id}/test

Send a signed test event

Param	In	Required
subscription_id	path	yes

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/v1/webhooks/{subscription_id}/deliveries

List webhook delivery attempts

Param	In	Required
subscription_id	path	yes
cursor	query	no
limit	query	no

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

POST/v1/webhooks/{subscription_id}/deliveries/{delivery_id}/redeliver

Redeliver a webhook delivery

Param	In	Required
subscription_id	path	yes
delivery_id	path	yes

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

System Meta & AI Discovery

GET/v1/meta/status

API status

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/v1/meta/freshness

Freshness SLA

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/v1/meta/plans

Plan matrix

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/llms.txt

Agent-facing API description

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.

GET/skill.md

AI Agent Integration Skill (SKILL.md)

Param	In	Required
modules	query	no
lang	query	no
agent	query	no
download	query	no

Response: {success, data, meta} on 2xx, {success: false, error} otherwise — see Errors & envelope.