# info.description
### Generate API keys

Visit https://globaltradealert.org/account/api-keys to generate a new API key.

# paths./api/v1/gta/data-counts/.post.description
This endpoint allows you to retrieve counts of interventions grouped by various dimensions such as implementer, date, sector, product, etc.

### Access
This endpoint can be accessed via the following request:

```bash
curl -X POST https://api.globaltradealert.org/api/v1/gta/data-counts/ \
-H 'Content-Type: application/json' \
-H 'Authorization: APIKey [YOUR_API_KEY]' \
-d '{[YOUR_REQUEST_BODY]}'
```
			

# paths./api/v1/gta/data-counts/.post.responses.200.content.application/json.examples.CountByImplementerAndYear.summary
Interventions by implementer and implementation year

# paths./api/v1/gta/data-counts/.post.responses.200.content.application/json.examples.CountByImplementerAndYear.description
Example showing intervention counts grouped by implementing jurisdiction and implementation year

# paths./api/v1/gta/data-counts/.post.responses.200.content.application/json.examples.CountByMASTChapter.description
Example showing intervention counts grouped by MAST chapter

# paths./api/v1/gta/data-counts/.post.responses.200.content.application/json.examples.CountProducts.description
Example showing count of unique affected products

# paths./api/v1/gta/data-counts/.post.responses.400.description
Bad Request - Invalid request parameters

# paths./api/v1/gta/impact-chains/product/.post.description
This endpoint allows querying of impact chain product data.

Note: Access requires a GTA API key with access level `id = 3` (full access).

### Access
This endpoint can be accessed via the following request:

```bash
curl -X POST https://api.globaltradealert.org/api/v1/gta/impact-chains/product/ \
-H 'Content-Type: application/json' \
-H 'Authorization: APIKey [YOUR_API_KEY]' \
-d '{[YOUR_REQUEST_BODY]}'
```

### Pagination
This endpoint allows to return a maximum of 1000 entries per request. Use the `limit` and `offset` parameters to paginate through the output.

I.e. to get the first 1000 entries, set the `limit` to 1000 and the `offset` to 0. To get the next 1000 entries, set the `limit` to 1000 and the `offset` to 1000, and so forth.

No entries are returned if the offset is higher than the total number of entries matching the request filters.
			

# paths./api/v1/gta/impact-chains/product/.post.responses.200.content.application/json.examples.FullAccessExample.value.results[].affected_product.name
Amine-function compounds; aromatic monoamines and their derivatives; salts thereof; n.e.c. in item no. 2921.4

# paths./api/v1/gta/impact-chains/sector/.post.description
This endpoint allows querying of impact chain sector data.

Note: Access requires a GTA API key with access level `id = 3` (full access).

### Access
This endpoint can be accessed via the following request:

```bash
curl -X POST https://api.globaltradealert.org/api/v1/gta/impact-chains/sector/ \
-H 'Content-Type: application/json' \
-H 'Authorization: APIKey [YOUR_API_KEY]' \
-d '{[YOUR_REQUEST_BODY]}'
```

### Pagination
This endpoint allows to return a maximum of 1000 entries per request. Use the `limit` and `offset` parameters to paginate through the output.

I.e. to get the first 1000 entries, set the `limit` to 1000 and the `offset` to 0. To get the next 1000 entries, set the `limit` to 1000 and the `offset` to 1000, and so forth.

No entries are returned if the offset is higher than the total number of entries matching the request filters.
			

# paths./api/v1/gta/mappings/.post.description
This endpoint allows querying of GTA mapping helpers.

### Access
This endpoint can be accessed via the following request:

```bash
curl -X POST https://api.globaltradealert.org/api/v1/gta/mappings/ \
-H 'Content-Type: application/json' \
-H 'Authorization: APIKey [YOUR_API_KEY]' \
-d '{[YOUR_REQUEST_BODY]}'
```
			

# paths./api/v1/gta/mappings/.post.responses.200.content.application/json.examples.FullAccessExample.value.threads[].description
Interventions related to critical minerals.

# paths./api/v1/gta/semantic-search/.post.operationId
Semantic search across GTA interventions

# paths./api/v1/gta/semantic-search/.post.description
This endpoint forwards a natural-language query to the GTA semantic-search RAG backend and returns the matching interventions ranked by semantic similarity.

### Access
This endpoint can be accessed via the following request:

```bash
curl -X POST https://api.globaltradealert.org/api/v1/gta/semantic-search/ \
-H 'Content-Type: application/json' \
-H 'Authorization: APIKey [YOUR_API_KEY]' \
-d '{"query": "steel tariffs in the EU", "limit": 10, "show_keys": ["intervention_id", "score"], "include_matched_snippets": true}'
```

### Access Levels
GTA API keys with access level `id = 1` (limited) and `id = 3` (full) can use this endpoint. The endpoint is also reachable via MCP using OAuth2 authentication.

### Parameters
- `query` (required): natural-language query, 1-1000 characters.
- `intervention_ids` (optional): list of intervention IDs to scope the search to.
- `limit` (optional): maximum number of results, default 20, capped at 100.
- `show_keys` (optional): list of field names to project per result. Use `["*"]` for the full record. Unknown names silently dropped by the RAG backend.
- `include_matched_snippets` (optional, default `false`): when `true`, each result carries 1-2 sentences from the intervention's description that matched the query.

### Rate Limits
APIKey usage is counted under the standard tiered rate limits. MCP usage is tier-limited (`FREE` / `PRO` / `MAX`) and counted via the IDs returned by the RAG backend.
            

# paths./api/v1/gta/semantic-search/.post.summary
Semantic search across GTA interventions

# paths./api/v1/gta/semantic-search/.post.responses.200.content.application/json.examples.ExampleResponse.value.results[].title
Intervention 142677: Netherlands: Government further expands export restrictions on advanced production equipment for semiconductors

# paths./api/v1/gta/semantic-search/.post.responses.200.content.application/json.examples.ExampleResponse.value.results[].blurb
Intervention 142677: Netherlands: Government further expands export restrictions on advanced production equipment for semiconductors

On 15 January 2025, the government of the Netherlands published Re

# paths./api/v1/gta/semantic-search/.post.responses.200.content.application/json.examples.ExampleResponse.value.query
export controls on semiconductor manufacturing equipment

# paths./api/v1/gta/semantic-search/.post.responses.200.description
Success — RAG backend response forwarded as-is.

# paths./api/v1/gta/state-act/.post.description
This endpoint allows querying of state acts with their associated interventions nested in the response. Filtering, sorting and permissions mirror the Data V2 interventions endpoint — a state act is returned when any of its interventions match the request filters.

### Access
This endpoint can be accessed via the following request:

```bash
curl -X POST https://api.globaltradealert.org/api/v1/gta/state-act/ \
-H 'Content-Type: application/json' \
-H 'Authorization: APIKey [YOUR_API_KEY]' \
-d '{[YOUR_REQUEST_BODY]}'
```

### Access Levels
GTA API keys with access level `id = 1` (limited) and `id = 3` (full) can use this endpoint. The access level determines which fields are included in the response (limited vs full output).

### Pagination
This endpoint returns up to 1000 state acts per request. Use the `limit` and `offset` parameters to paginate through the output. Pagination applies to state acts; all matching interventions of a returned state act are always included in the nested `interventions` array.

### Nested interventions
Each state act embeds **all** of its interventions (subject to the same access-level gating as Data V2). Fields carried by the parent state act — `state_act_id`, `date_announced`, `date_published`, and for full access `state_act_source` / `is_official_source` — are omitted from each nested intervention to avoid redundancy.

### Full access format
For users with full access rights, additional fields are included in the response:

- `state_act_source`: Source information as shown on our website.
- `is_official_source`: Boolean indicator whether this state act is based on an official source.
- `intervention_description` on each nested intervention.
- `affected_products` on nested interventions includes prior/new levels and units.
            

# paths./api/v1/gta/state-act/.post.responses.200.content.application/json.examples.FullAccessExample.value.results[].state_act_title
EU: Changes to the list of agricultural and industrial products subject to a reduction of import duties (July 2024)

# paths./api/v1/gta/state-act/.post.responses.200.content.application/json.examples.FullAccessExample.value.results[].state_act_source[].source
Official Journal of the EU - EUR-Lex (4 July 2024). Council Regulation (EU) 2024/1851 ...

# paths./api/v1/gta/state-act/.post.responses.200.content.application/json.examples.FullAccessExample.value.results[].interventions[].state_act_title
EU: Changes to the list of agricultural and industrial products subject to a reduction of import duties (July 2024)

# paths./api/v1/gta/state-act/.post.responses.200.content.application/json.examples.FullAccessExample.value.results[].interventions[].intervention_description[].description
On 4 July 2024, the European Union adopted Council Regulation (EU) 2024/1851 ...

# paths./api/v1/gta/state-act/.post.responses.200.content.application/json.examples.FullAccessExample.summary
State act with nested interventions (full access)

# paths./api/v1/gta/state-act/.post.responses.200.content.application/json.examples.FullAccessExample.description
Complete example showing all available fields for full-access users

# paths./api/v1/gta/state-act/.post.responses.200.content.application/json.examples.LimitedAccessExample.value.results[].state_act_title
EU: Changes to the list of agricultural and industrial products subject to a reduction of import duties (July 2024)

# paths./api/v1/gta/state-act/.post.responses.200.content.application/json.examples.LimitedAccessExample.value.results[].interventions[].state_act_title
EU: Changes to the list of agricultural and industrial products subject to a reduction of import duties (July 2024)

# paths./api/v1/gta/state-act/.post.responses.200.content.application/json.examples.LimitedAccessExample.summary
State act with nested interventions (limited access)

# paths./api/v1/gta/state-act/.post.responses.200.content.application/json.examples.LimitedAccessExample.description
Example showing the fields available for limited-access users

# paths./api/v1/gta/ticker/.post.description
This endpoint allows querying of database updates.

### Access
This endpoint can be accessed via the following request:

```bash
curl -X POST https://api.globaltradealert.org/api/v1/gta/ticker/ \
-H 'Content-Type: application/json' \
-H 'Authorization: APIKey [YOUR_API_KEY]' \
-d '{[YOUR_REQUEST_BODY]}'
```

### Access Levels
GTA API keys with access level `id = 1` (limited) and `id = 3` (full) can use this endpoint.
The access level determines which fields are included in the response (limited vs full output).

### Pagination
This endpoint allows to return a maximum of 1000 entries per request. Use the `limit` and `offset` parameters to paginate through the output.

I.e. to get the first 1000 entries, set the `limit` to 1000 and the `offset` to 0. To get the next 1000 entries, set the `limit` to 1000 and the `offset` to 1000, and so forth.

No entries are returned if the offset is higher than the total number of entries matching the request filters.
			

# paths./api/v1/gta/ticker/.post.responses.200.content.application/json.examples.FullAccessExample.value.results[].description
On 4 July 2024, the European Union adopted Council Regulation (EU) 2024/1851...

# paths./api/v1/gta/ticker/.post.responses.200.content.application/json.examples.FullAccessExample.value.results[].intervention.state_act_title
EU: Changes to the list of agricultural and industrial products subject to a reduction of import duties (July 2024)

# paths./api/v1/tau/aggregate/advantage/.get.description
For one origin country, rank its top-N products by trade value and report each product's applied rate alongside the peer-weighted rate (all other origins) and the resulting advantage in percentage points.

Pass `compare_un_code` to compare against a single peer country instead of the rest of the world.

# paths./api/v1/tau/aggregate/advantage/.get.summary
Per-product tariff advantage vs. peers (or a specific peer)

# paths./api/v1/tau/aggregate/advantage/.get.parameters[].description
Comma-separated names of proposed / parked actions to un-park for this request only — stateless: no scenario is stored or mutated. When supplied, the engine computes as if the named action were in force, applying its blanket rate, the partial carve-outs, and all full exclusions dynamically, and returns the authoritative rates (and, on aggregate endpoints, the engine-computed trade-weighted average). Activatable names come from `/api/v1/tau/reference/proposals/` — currently `bra_s301` (Brazil negative-list Section 301 — FINALISED, in force 2026-07-22; activation only changes results for policy dates before that) and `fl_s301` (proposed forced-labour Section 301). Unknown names return 400.

# paths./api/v1/tau/aggregate/advantage/.get.parameters[].description
Optional UN M49 code of a single peer country. When omitted, the peer is the rest of the world.

# paths./api/v1/tau/aggregate/advantage/.get.parameters[].description
ISO date YYYY-MM-DD. Must be on or after 2025-01-20 (the US presidential-transition floor; the model does not cover the pre-2025 regime). Each date reconstructs the tariff regime stack in force on that date — so 2026-02-15 returns the IEEPA world and 2026-03-01 returns the post-SCOTUS S122 world.

# paths./api/v1/tau/aggregate/advantage/.get.parameters[].description
Scenario identifier. `1` (default) is the read-only baseline. Create custom scenarios via POST /api/v1/tau/scenario/, then adjust deal toggles via PUT /api/v1/tau/deal/toggle/?scenario_id=...&name=....

# paths./api/v1/tau/aggregate/advantage/.get.parameters[].description
Number of products to compare. Default 20, capped at 50.

# paths./api/v1/tau/aggregate/advantage/.get.parameters[].description
UN M49 numeric code of the focus country.

# paths./api/v1/tau/aggregate/advantage/.get.responses.404.description
Unknown un_code or no flows for this country

# paths./api/v1/tau/aggregate/country_brief/.get.description
For one origin country, return an HS2 chapter breakdown (trade-weighted rate, trade volume in $bn, flow count) plus the top-N most-exposed HS8 products with their final rate and formula label.

Useful for compact country exposure briefings.

# paths./api/v1/tau/aggregate/country_brief/.get.summary
HS2 chapter breakdown + top-N exposed products for one country

# paths./api/v1/tau/aggregate/country_brief/.get.parameters[].description
Comma-separated names of proposed / parked actions to un-park for this request only — stateless: no scenario is stored or mutated. When supplied, the engine computes as if the named action were in force, applying its blanket rate, the partial carve-outs, and all full exclusions dynamically, and returns the authoritative rates (and, on aggregate endpoints, the engine-computed trade-weighted average). Activatable names come from `/api/v1/tau/reference/proposals/` — currently `bra_s301` (Brazil negative-list Section 301 — FINALISED, in force 2026-07-22; activation only changes results for policy dates before that) and `fl_s301` (proposed forced-labour Section 301). Unknown names return 400.

# paths./api/v1/tau/aggregate/country_brief/.get.parameters[].description
ISO date YYYY-MM-DD. Must be on or after 2025-01-20 (the US presidential-transition floor; the model does not cover the pre-2025 regime). Each date reconstructs the tariff regime stack in force on that date — so 2026-02-15 returns the IEEPA world and 2026-03-01 returns the post-SCOTUS S122 world.

# paths./api/v1/tau/aggregate/country_brief/.get.parameters[].description
Scenario identifier. `1` (default) is the read-only baseline. Create custom scenarios via POST /api/v1/tau/scenario/, then adjust deal toggles via PUT /api/v1/tau/deal/toggle/?scenario_id=...&name=....

# paths./api/v1/tau/aggregate/country_brief/.get.parameters[].description
Number of top-exposed products to surface. Default 20, capped at 100.

# paths./api/v1/tau/aggregate/country_brief/.get.parameters[].description
UN M49 numeric code of the focus country.

# paths./api/v1/tau/aggregate/country_brief/.get.responses.404.description
Unknown un_code or no flows for this country

# paths./api/v1/tau/aggregate/country_ranking/.get.description
Rank the members of a country group by their trade-weighted applied rate on `policy_date`. With `compare_date`, rank by the rate **delta** (policy_date minus compare_date) instead — useful for surfacing winners and losers of a regime change.

Available groups: `WORLD`, `G20`, `G7`, `BRICS`, `ASEAN`, `LDC`. Default: `G20`.

# paths./api/v1/tau/aggregate/country_ranking/.get.summary
Top-N countries by applied rate (or rate delta)

# paths./api/v1/tau/aggregate/country_ranking/.get.parameters[].description
Comma-separated names of proposed / parked actions to un-park for this request only — stateless: no scenario is stored or mutated. When supplied, the engine computes as if the named action were in force, applying its blanket rate, the partial carve-outs, and all full exclusions dynamically, and returns the authoritative rates (and, on aggregate endpoints, the engine-computed trade-weighted average). Activatable names come from `/api/v1/tau/reference/proposals/` — currently `bra_s301` (Brazil negative-list Section 301 — FINALISED, in force 2026-07-22; activation only changes results for policy dates before that) and `fl_s301` (proposed forced-labour Section 301). Unknown names return 400.

# paths./api/v1/tau/aggregate/country_ranking/.get.parameters[].description
Optional second date. When supplied, rows are ranked by `policy_date` rate minus `compare_date` rate (largest delta first).

# paths./api/v1/tau/aggregate/country_ranking/.get.parameters[].description
ISO date YYYY-MM-DD. Must be on or after 2025-01-20 (the US presidential-transition floor; the model does not cover the pre-2025 regime). Each date reconstructs the tariff regime stack in force on that date — so 2026-02-15 returns the IEEPA world and 2026-03-01 returns the post-SCOTUS S122 world.

# paths./api/v1/tau/aggregate/country_ranking/.get.parameters[].description
Top-trade flows per country to weight by. Default 200, capped at 1000.

# paths./api/v1/tau/aggregate/country_ranking/.get.parameters[].description
Scenario identifier. `1` (default) is the read-only baseline. Create custom scenarios via POST /api/v1/tau/scenario/, then adjust deal toggles via PUT /api/v1/tau/deal/toggle/?scenario_id=...&name=....

# paths./api/v1/tau/aggregate/country_ranking/.get.parameters[].description
Number of countries to return. Default 10, capped at 50.

# paths./api/v1/tau/aggregate/timeline/.get.description
Sample the applied tariff rate across a date range and return one trade-weighted row per sampled policy date. Mirrors the columns of the SGEPT us-tariff-barrier-estimates `timeline_data.csv` artifact.

By default the endpoint samples canonical policy-change dates that fall inside `[start_date, end_date]`, plus the two endpoints. Pass `dates=YYYY-MM-DD,YYYY-MM-DD,...` to override the sampling grid (≤ 60 dates).

Pass `countries=UN1,UN2,...` (≤ 10) to additionally compute a per-country trade-weighted rate for each sampled date — surfaced as `rows[*].country_rates` and useful for comparative time-series overlays.

# paths./api/v1/tau/aggregate/timeline/.get.summary
Trade-weighted tariff timeline across a date range

# paths./api/v1/tau/aggregate/timeline/.get.parameters[].description
Comma-separated names of proposed / parked actions to un-park for this request only — stateless: no scenario is stored or mutated. When supplied, the engine computes as if the named action were in force, applying its blanket rate, the partial carve-outs, and all full exclusions dynamically, and returns the authoritative rates (and, on aggregate endpoints, the engine-computed trade-weighted average). Activatable names come from `/api/v1/tau/reference/proposals/` — currently `bra_s301` (Brazil negative-list Section 301 — FINALISED, in force 2026-07-22; activation only changes results for policy dates before that) and `fl_s301` (proposed forced-labour Section 301). Unknown names return 400.

# paths./api/v1/tau/aggregate/timeline/.get.parameters[].description
Comma-separated UN M49 codes (≤ 10) for per-country overlay rates.

# paths./api/v1/tau/aggregate/timeline/.get.parameters[].description
Comma-separated ISO dates to override the canonical sampling grid. Hard-capped at 60 dates.

# paths./api/v1/tau/aggregate/timeline/.get.parameters[].description
ISO end date YYYY-MM-DD. Must be ≥ start_date.

# paths./api/v1/tau/aggregate/timeline/.get.parameters[].description
Single 8-digit HTS code to restrict the aggregation.

# paths./api/v1/tau/aggregate/timeline/.get.parameters[].description
Two-digit HS chapter (e.g. `87` for vehicles).

# paths./api/v1/tau/aggregate/timeline/.get.parameters[].description
Number of top-trade flows to weight by. Default 1000, capped at 5000.

# paths./api/v1/tau/aggregate/timeline/.get.parameters[].description
Scenario identifier. `1` (default) is the read-only baseline. Create custom scenarios via POST /api/v1/tau/scenario/, then adjust deal toggles via PUT /api/v1/tau/deal/toggle/?scenario_id=...&name=....

# paths./api/v1/tau/aggregate/timeline/.get.parameters[].description
Restrict the trade-weighted aggregation to flows from a single origin country.

# paths./api/v1/tau/calculate/batch/.get.description
Compute rates for up to N product-country pairs in one call. Supports chapter / country filters. Returns a DRF-paginated response. Use this for aggregation and cross-cutting analysis; for explanatory detail on one pair, call `/calculate/single/kit/`.

# paths./api/v1/tau/calculate/batch/.get.summary
Applied tariff rates for many product-country pairs

# paths./api/v1/tau/calculate/batch/.get.parameters[].description
Comma-separated names of proposed / parked actions to un-park for this request only — stateless: no scenario is stored or mutated. When supplied, the engine computes as if the named action were in force, applying its blanket rate, the partial carve-outs, and all full exclusions dynamically, and returns the authoritative rates (and, on aggregate endpoints, the engine-computed trade-weighted average). Activatable names come from `/api/v1/tau/reference/proposals/` — currently `bra_s301` (Brazil negative-list Section 301 — FINALISED, in force 2026-07-22; activation only changes results for policy dates before that) and `fl_s301` (proposed forced-labour Section 301). Unknown names return 400.

# paths./api/v1/tau/calculate/batch/.get.parameters[].description
If true, skip USMCA-compliance weighting on the HTS layer for Canada and Mexico. Analytical use; rarely needed.

# paths./api/v1/tau/calculate/batch/.get.parameters[].description
If true, zero the positive-list Section 301 layer (China). Useful for counterfactual 'what if S301 were removed?' analysis. Does NOT disable the negative-list Section 301 archetype (e.g. the Brazil blanket, in force 2026-07-22) or the forced-labour S301 additive layer - recent measures absent from observed-MFN baselines.

# paths./api/v1/tau/calculate/batch/.get.parameters[].description
HS8 codes to restrict the batch, given either as repeated `hs_8digit=` params or comma-separated in one. Every value is applied; codes matching no import row are reported under `filters.hs_8digit.unmatched` in the response. At least one of `hs_8digit`, `un_code`, or `hs_chapter` is required.

# paths./api/v1/tau/calculate/batch/.get.parameters[].description
Two-digit HS chapter to restrict the batch (e.g. `87` for vehicles). At least one of `hs_8digit`, `un_code`, or `hs_chapter` is required.

# paths./api/v1/tau/calculate/batch/.get.parameters[].description
Max rows per page. Default 100, hard-capped at 1000.

# paths./api/v1/tau/calculate/batch/.get.parameters[].description
Source for the MFN (HTS) layer. `hts_schedule` (default) is the statutory rate from the US Harmonized Tariff Schedule. The three empirical variants — `mixed_schedule`, `observed_product`, `observed_bilateral` — derive rates from 2024 customs revenue. Most users want the default.

# paths./api/v1/tau/calculate/batch/.get.parameters[].description
ISO date YYYY-MM-DD. Must be on or after 2025-01-20 (the US presidential-transition floor; the model does not cover the pre-2025 regime). Each date reconstructs the tariff regime stack in force on that date — so 2026-02-15 returns the IEEPA world and 2026-03-01 returns the post-SCOTUS S122 world.

# paths./api/v1/tau/calculate/batch/.get.parameters[].description
Scenario identifier. `1` (default) is the read-only baseline. Create custom scenarios via POST /api/v1/tau/scenario/, then adjust deal toggles via PUT /api/v1/tau/deal/toggle/?scenario_id=...&name=....

# paths./api/v1/tau/calculate/batch/.get.parameters[].description
UN M49 codes to restrict the batch, given either as repeated `un_code=` params or comma-separated in one. Every value is applied. At least one of `hs_8digit`, `un_code`, or `hs_chapter` is required.

# paths./api/v1/tau/calculate/batch/.get.responses.400.description
Missing or invalid parameters. Includes an `hs_8digit` that is well-formed but names no HTSUS schedule line — the endpoint rejects it by code rather than returning a computed rate.

# paths./api/v1/tau/calculate/single/.get.description
Calculate the **applied** US tariff rate (not statutory MFN) for a single product-country-date combination, as implied by the full set of tariff measures in force on that date.

Returns the final rate decomposed into six instruments (HTS / S232 / IEEPA / S122 / Emergency / S301) plus the formula identifier. For the full explanatory kit (formula expression, tunable parameters, deals in force with counterfactuals), use `/calculate/single/kit/` instead.

**S232 polysilicon (from 2026-12-04):** doped ingots and wafers (3818.00), cells (8541.42) and modules (8541.43) carry 15%; raw polysilicon (2804.61) is in scope at **0% ad valorem** — the proclamation applies only a minimum-import-price program to it, which this ad valorem engine does not price, so a 0.0 on that line is a modelled value and not a missing one. The UK pays a flat 10% additive; the EU, Switzerland, Liechtenstein, Japan, Korea and Taiwan pay a 15% HTS-inclusive combined ceiling.

**S232 unmanned aircraft systems (from 2026-09-03):** UAS over 25kg (8806.24/29, 8806.94/99) carry 100%; sub-25kg UAS (8806.21/22/23, 8806.91/92/93) carry a value-weighted blend of the 100% thermal-imaging leg and the 25% non-thermal leg. On the four 8807 aircraft-parts baskets and on static converters 8504.40.95 the action is END-USE LIMITED: chapter 99 heading 9903.08.20 leaves articles not for use in UAS on their existing footing, so only the UAS-use share of the line carries S232 and the remainder keeps paying IEEPA/S122 — that split is why these rows report `rate_formula` "UAS S232: HTS + share×S232(…)" rather than the whole-code variant. Control panels 8537.10.91 stay auto-parts-owned and carry a blend of both actions' rates. The Annex III components tranche adds the remaining UAS parts at 25% from **2027-02-09**. Country carve-outs mirror polysilicon: UK flat 10% additive, EU/CHE/LIE/JPN/KOR/TWN a 15% HTS-inclusive combined ceiling.

**Authentication:** MCP OAuth2 Bearer token OR API key with calculate-tariff permission. Baseline calculations are available at all access tiers; custom scenarios require per-key authorisation.

# paths./api/v1/tau/calculate/single/.get.summary
Applied tariff rate for one product-country-date

# paths./api/v1/tau/calculate/single/.get.parameters[].description
Comma-separated names of proposed / parked actions to un-park for this request only — stateless: no scenario is stored or mutated. When supplied, the engine computes as if the named action were in force, applying its blanket rate, the partial carve-outs, and all full exclusions dynamically, and returns the authoritative rates (and, on aggregate endpoints, the engine-computed trade-weighted average). Activatable names come from `/api/v1/tau/reference/proposals/` — currently `bra_s301` (Brazil negative-list Section 301 — FINALISED, in force 2026-07-22; activation only changes results for policy dates before that) and `fl_s301` (proposed forced-labour Section 301). Unknown names return 400.

# paths./api/v1/tau/calculate/single/.get.parameters[].description
If true, skip USMCA-compliance weighting on the HTS layer for Canada and Mexico. Analytical use; rarely needed.

# paths./api/v1/tau/calculate/single/.get.parameters[].description
If true, zero the positive-list Section 301 layer (China). Useful for counterfactual 'what if S301 were removed?' analysis. Does NOT disable the negative-list Section 301 archetype (e.g. the Brazil blanket, in force 2026-07-22) or the forced-labour S301 additive layer - recent measures absent from observed-MFN baselines.

# paths./api/v1/tau/calculate/single/.get.parameters[].description
8-digit US HTS code. Finer than HS8 is not supported. Use `/api/v1/tau/reference/products/` to find a valid code.

# paths./api/v1/tau/calculate/single/.get.parameters[].description
Source for the MFN (HTS) layer. `hts_schedule` (default) is the statutory rate from the US Harmonized Tariff Schedule. The three empirical variants — `mixed_schedule`, `observed_product`, `observed_bilateral` — derive rates from 2024 customs revenue. Most users want the default.

# paths./api/v1/tau/calculate/single/.get.parameters[].description
ISO date YYYY-MM-DD. Must be on or after 2025-01-20 (the US presidential-transition floor; the model does not cover the pre-2025 regime). Each date reconstructs the tariff regime stack in force on that date — so 2026-02-15 returns the IEEPA world and 2026-03-01 returns the post-SCOTUS S122 world.

# paths./api/v1/tau/calculate/single/.get.parameters[].description
Scenario identifier. `1` (default) is the read-only baseline. Create custom scenarios via POST /api/v1/tau/scenario/, then adjust deal toggles via PUT /api/v1/tau/deal/toggle/?scenario_id=...&name=....

# paths./api/v1/tau/calculate/single/.get.parameters[].description
UN M49 numeric country code. Use `/api/v1/tau/reference/countries/` to resolve names / ISO3 to the canonical code. Note: GTA's UN codes diverge from some standard UN M49 values — India is 699 in GTA (not 356). Always trust the value returned by `/api/v1/tau/reference/countries/`.

# paths./api/v1/tau/calculate/single/.get.responses.400.description
Missing or invalid parameters. Includes an `hs_8digit` that is well-formed but names no HTSUS schedule line — the endpoint rejects it by code rather than returning a computed rate.

# paths./api/v1/tau/calculate/single/kit/.get.description
Extends `/calculate/single/` with a **self-contained `calculation_kit`** payload so LLM clients (e.g. the sgept-gta-mcp tariff tools) can:

- Explain the rate by naming the formula and showing its   variables.
- Offer interactive sensitivity controls over tunable   parameters with sensitivity hints.
- Surface which bilateral deals are in force and what the   rate would be without each one (counterfactuals).

The kit is designed to eliminate additional API round-trips when building sensitivity artifacts in downstream clients.

**Authentication:** same as `/calculate/single/`. The endpoint is registered in `APIEndpoint` so API-key callers with calculate-tariff permission can reach it.

**Response shape:**

- `baseline` — identical to `/calculate/single/` response.
- `calculation_kit.formula_name` / `calculation_kit.formula_expression_python` — what the engine evaluated.
- `calculation_kit.tunable_parameters` — list of parameters you can substitute for client-side what-if (each with `min`/`max`/`step`/`sensitivity`). **May be empty** when the rate is fully determined by regime defaults.
- `calculation_kit.fixed_values` — pre-resolved inputs to the formula (USMCA compliance, aircraft share, etc.).
- `calculation_kit.deals_in_force` — bilateral deals affecting this combination, with `counterfactual_final_rate` showing the rate without each deal.

**Gotchas to be aware of:**
- Metal content ratios are empirical incidence ratios, NOT   physical metal content percentages.
- The Japan, EU and Korea S232 floors all apply to auto and   auto parts only. MHDV (heavy trucks, buses, MHDV parts) pays   the standard S232 rates regardless of origin.
- The SCOTUS boundary is 2026-02-20: before this, IEEPA   layer active and S122 = 0; on/after, IEEPA = 0 and the   default S122 = 15% (effective 2026-02-24). Bilateral floor   deals (EU, Japan, Korea) override this — for example,   EU-origin product-country combinations covered by the   EU tariff floor land at 10%, not 15%.

# paths./api/v1/tau/calculate/single/kit/.get.summary
Applied tariff rate + full calculation kit (formula, tunables, deals)

# paths./api/v1/tau/calculate/single/kit/.get.parameters[].description
Comma-separated names of proposed / parked actions to un-park for this request only — stateless: no scenario is stored or mutated. When supplied, the engine computes as if the named action were in force, applying its blanket rate, the partial carve-outs, and all full exclusions dynamically, and returns the authoritative rates (and, on aggregate endpoints, the engine-computed trade-weighted average). Activatable names come from `/api/v1/tau/reference/proposals/` — currently `bra_s301` (Brazil negative-list Section 301 — FINALISED, in force 2026-07-22; activation only changes results for policy dates before that) and `fl_s301` (proposed forced-labour Section 301). Unknown names return 400.

# paths./api/v1/tau/calculate/single/kit/.get.parameters[].description
If true, skip USMCA-compliance weighting on the HTS layer for Canada and Mexico. Analytical use; rarely needed.

# paths./api/v1/tau/calculate/single/kit/.get.parameters[].description
If true, zero the positive-list Section 301 layer (China). Useful for counterfactual 'what if S301 were removed?' analysis. Does NOT disable the negative-list Section 301 archetype (e.g. the Brazil blanket, in force 2026-07-22) or the forced-labour S301 additive layer - recent measures absent from observed-MFN baselines.

# paths./api/v1/tau/calculate/single/kit/.get.parameters[].description
8-digit US HTS code. Finer than HS8 is not supported. Use `/api/v1/tau/reference/products/` to find a valid code.

# paths./api/v1/tau/calculate/single/kit/.get.parameters[].description
Source for the MFN (HTS) layer. `hts_schedule` (default) is the statutory rate from the US Harmonized Tariff Schedule. The three empirical variants — `mixed_schedule`, `observed_product`, `observed_bilateral` — derive rates from 2024 customs revenue. Most users want the default.

# paths./api/v1/tau/calculate/single/kit/.get.parameters[].description
ISO date YYYY-MM-DD. Must be on or after 2025-01-20 (the US presidential-transition floor; the model does not cover the pre-2025 regime). Each date reconstructs the tariff regime stack in force on that date — so 2026-02-15 returns the IEEPA world and 2026-03-01 returns the post-SCOTUS S122 world.

# paths./api/v1/tau/calculate/single/kit/.get.parameters[].description
Scenario identifier. `1` (default) is the read-only baseline. Create custom scenarios via POST /api/v1/tau/scenario/, then adjust deal toggles via PUT /api/v1/tau/deal/toggle/?scenario_id=...&name=....

# paths./api/v1/tau/calculate/single/kit/.get.parameters[].description
UN M49 numeric country code. Use `/api/v1/tau/reference/countries/` to resolve names / ISO3 to the canonical code. Note: GTA's UN codes diverge from some standard UN M49 values — India is 699 in GTA (not 356). Always trust the value returned by `/api/v1/tau/reference/countries/`.

# paths./api/v1/tau/calculate/single/kit/.get.responses.200.content.application/json.examples.GermanyAutos,Post-SCOTUS,FullKit.value.calculation_kit.formula_description
Transport S232 (auto, auto parts, MHDV, PV parts). S232 replaces IEEPA entirely. Emergency tariffs still apply additively.

# paths./api/v1/tau/calculate/single/kit/.get.responses.200.content.application/json.examples.GermanyAutos,Post-SCOTUS,FullKit.value.calculation_kit.formula_expression_python
hts_weighted + transport_share * s232_rate + emergency_weighted + s301 + s338 + surcharge

# paths./api/v1/tau/calculate/single/kit/.get.responses.200.content.application/json.examples.GermanyAutos,Post-SCOTUS,FullKit.value.calculation_kit.formula_expression_javascript
hts_weighted + transport_share * s232_rate + emergency_weighted + s301 + s338 + surcharge

# paths./api/v1/tau/calculate/single/kit/.get.responses.200.content.application/json.examples.GermanyAutos,Post-SCOTUS,FullKit.value.calculation_kit.tunable_parameters[].description
Fraction of product subject to the transport S232 rate.

# paths./api/v1/tau/calculate/single/kit/.get.responses.200.content.application/json.examples.GermanyAutos,Post-SCOTUS,FullKit.value.calculation_kit.deals_in_force[].verbal_spec
The EU Tariff Floor Deal applies to all 27 EU member states. S232 auto and auto parts use floor formulas (MHDV is not in the deal and pays the standard S232 rates). IEEPA uses product-specific floor rates.

# paths./api/v1/tau/calculate/single/kit/.get.responses.200.content.application/json.examples.GermanyAutos,Post-SCOTUS,FullKit.value.calculation_kit.artifact_suggestion
1 deal(s) are in force. Each has a 'counterfactual_final_rate' showing what would happen without that deal. Consider offering a toggle for each deal.

# paths./api/v1/tau/calculate/single/kit/.get.responses.400.description
Missing or invalid parameters. Includes an `hs_8digit` that is well-formed but names no HTSUS schedule line — the endpoint rejects it by code rather than returning a computed rate.

# paths./api/v1/tau/deal/.get.description
Show which bilateral deals are enabled/disabled for the requested scenario. Custom scenarios inherit their initial toggles from the baseline; modify via PUT `/deal/toggle/?scenario_id=...&name=...`.

# paths./api/v1/tau/deal/.get.parameters[].description
The initial index from which to return the results.

# paths./api/v1/tau/deal/.get.parameters[].description
Scenario whose deal toggles should be returned.

# paths./api/v1/tau/deal/toggle/.put.description
Toggle a specific deal on or off for the given scenario. The baseline (id=1) is read-only.

Valid deal names: `uk_economic_prosperity`, `japan_tariff_floor`, `eu_tariff_floor`, `korea_deal`, `switzerland_floor`, `brazil_topup`, `canada_border_emergency`, `mexico_border_emergency`, `china_opioid_emergency`.

# paths./api/v1/tau/deal/toggle/.put.summary
Enable or disable a bilateral deal for a scenario

# paths./api/v1/tau/deal/toggle/.put.responses.400.description
Unknown name or missing is_active payload

# paths./api/v1/tau/reference/countries/.get.description
List the countries covered by the estimate. Each record carries the UN M49 numeric code, country name, and boolean flags `is_ieepa` (member of an IEEPA country group) and `is_s232_steel` (member of the S232 steel group). Returns a DRF-paginated response; use `limit`/`offset` to page through large result sets.

**Gotcha:** GTA's UN codes diverge from some standard UN M49 values. This endpoint is authoritative — always resolve country identities here before passing `un_code` to `/calculate/*` endpoints.

# paths./api/v1/tau/reference/countries/.get.summary
Countries with UN codes and regime flags

# paths./api/v1/tau/reference/countries/.get.parameters[].description
Max rows per page. Default 20, hard-capped at 1000.

# paths./api/v1/tau/reference/countries/.get.parameters[].description
Country name substring (case-insensitive). Minimum 2 characters.

# paths./api/v1/tau/reference/dictionary/.get.description
Download the complete HTSUS 8-digit schedule as a code -> description mapping, sourced from the same product universe the engine prices against and `products` searches (`tau/data/us_hts8_universe.csv`, mirrored from the SGEPT us-tariff-barrier-estimates reference repo) — so this dictionary cannot drift from either.

`output=csv` (default) streams a downloadable file with provenance/vintage metadata (source file, upstream mirror, row count, sha256 fingerprint) carried in response headers (`X-Dictionary-*`). `output=json` returns the identical data inline with the same metadata as a top-level `provenance` object.

Note the parameter is `output`, not `format` — DRF reserves `format` for its own content-negotiation override.

This is the canonical reference the Register workbooks' Read-me sheet points to, now that per-row product descriptions have been dropped from delivered files (JF-1977 / JF-1980).

# paths./api/v1/tau/reference/dictionary/.get.summary
Download the full HTS8 code -> description dictionary

# paths./api/v1/tau/reference/dictionary/.get.parameters[].description
Response format. `csv` streams a downloadable file; `json` returns the same data inline.

# paths./api/v1/tau/reference/dictionary/.get.responses.200.description
Success — CSV stream or JSON body per `output`

# paths./api/v1/tau/reference/products/.get.description
Search the HTSUS 8-digit schedule by HS code prefix. Pass a 2–8 digit prefix as `search` to narrow by chapter, heading, or sub-heading. Returns a DRF-paginated response; use `limit`/`offset` to page through large chapters.

The universe is the schedule, not the codes with observed trade: a line that exists but recorded no US imports in the reference year is returned with `has_us_import_flows=false` rather than omitted.

# paths./api/v1/tau/reference/products/.get.parameters[].description
Max rows per page. Default 20, hard-capped at 1000.

# paths./api/v1/tau/reference/products/.get.parameters[].description
HS code prefix (2–8 digits). Minimum 2 characters.

# paths./api/v1/tau/reference/proposals/.get.description
List the proposed / parked tariff actions a client can un-park per request via the `activate_proposals=` parameter on the calculate and aggregate endpoints.

A parked action is coded into the engine behind a far-future effective_date, so it evaluates to 0 at every realistic policy date until activated. A finalised action (e.g. `bra_s301`, in force 2026-07-22) stays listed: activating it only changes results for policy dates before its real effective date. Activation is **stateless**: it computes as if the named action were in force for that one request, without creating or mutating any scenario.

Each record carries the `name` to pass in `activate_proposals`, a `title`, the `archetype` (`negative_list` or `forced_labour`), a `description`, and the engine `rate_types` the activation un-parks.

# paths./api/v1/tau/reference/timeline/.get.description
Return the 2025+ US tariff policy timeline as an ordered list of regime-activation events: policy regimes and active bilateral deals with effective dates. Useful as the backbone of `tariff_timeline`-style analyses.

# paths./api/v1/tau/reference/timeline/.get.summary
US tariff policy timeline (regime activation dates)

# paths./api/v1/tau/scenario/.get.description
List all tariff policy scenarios accessible to this caller.

The **baseline scenario** (`id=1`) contains the default rates, shares, and deal toggles calibrated from the SGEPT US Tariff Barrier Estimates. It is read-only.

**Custom scenarios** inherit the baseline and then accept modifications via PUT /scenario/{id}/ and the deal-toggle endpoints. Use custom scenarios to run counterfactual analyses (what if S122 were 20%? what if the EU deal were revoked?).

Results are ordered with the baseline first, then by id.

# paths./api/v1/tau/scenario/.get.parameters[].description
The initial index from which to return the results.

# paths./api/v1/tau/scenario/.post.description
Create a new custom scenario inheriting all baseline rates, shares, exceptions, and deal toggles. The new scenario can then be modified via subsequent PUT calls without affecting the baseline.

Requires a write-capable API key or MCP OAuth token with `mcp:write` scope.

# paths./api/v1/tau/scenario/{id}/.get.parameters[].description
A unique integer value identifying this scenario.

# paths./api/v1/tau/scenario/{id}/.put.description
Update a custom scenario. The baseline (id=1) is read-only and returns 403.

# paths./api/v1/tau/scenario/{id}/.put.parameters[].description
A unique integer value identifying this scenario.

# paths./api/v1/tau/scenario/{id}/.patch.parameters[].description
A unique integer value identifying this scenario.

# paths./api/v1/tau/scenario/{id}/.delete.description
Delete a custom scenario. The baseline (id=1) cannot be deleted.

# paths./api/v1/tau/scenario/{id}/.delete.parameters[].description
A unique integer value identifying this scenario.

# paths./api/v1/usage/.get.description
Returns the authenticated key account overview: enabled packages, active API keys, and per-product (GTA / DPA / Clairk) daily and weekly usage and limits. Not package-gated and does not consume quota.

# paths./api/v2/gta/data/.post.description
This endpoint allows querying of trade policies (V2) with various filters and parameters.
It provides detailed information about trade interventions, including their IDs, state act details, and descriptions.

### Access
This endpoint can be accessed via the following request:

```bash
curl -X POST https://api.globaltradealert.org/api/v2/gta/data/ \
-H 'Content-Type: application/json' \
-H 'Authorization: APIKey [YOUR_API_KEY]' \
-d '{[YOUR_REQUEST_BODY]}'
```

### Access Levels
GTA API keys with access level `id = 1` (limited) and `id = 3` (full) can use this endpoint.
The access level determines which fields are included in the response (limited vs full output).

### Pagination
This endpoint allows to return a maximum of 1000 entries per request. Use the `limit` and `offset` parameters to paginate through the output.

I.e. to get the first 1000 entries, set the `limit` to 1000 and the `offset` to 0. To get the next 1000 entries, set the `limit` to 1000 and the `offset` to 1000, and so forth.

No entries are returned if the offset is higher than the total number of entries matching the request filters.

### Full access format
For users with full access rights, additional fields are being outputted by the endpoint:

- `affected_products`: This field now outputs prior and new levels, as well as the unit of those levels if applicable.
- `intervention_description`: Intervention description as can be found on our website.
- `state_act_source`: Source information as can be found on our website.
- `is_official_source`: Boolean indicator whether this state act is based on an official source or not.
            

# paths./api/v2/gta/data/.post.responses.200.content.application/json.examples.FullAccessExample.value.results[].state_act_title
EU: Changes to the list of agricultural and industrial products subject to a reduction of import duties (July 2024)

# paths./api/v2/gta/data/.post.responses.200.content.application/json.examples.FullAccessExample.value.results[].intervention_description[].description
On 4 July 2024, the European Union adopted Council Regulation (EU) 2024/1851 increasing the import duties of 49 agricultural and industrial products enclosed in 20 six-digit tariff subheadings. Specifically, the regulation eliminates these goods from the list of products with a temporary customs duty suspension. The measure enters into force retroactively on 1 July 2024.

Among the affected products there are several chemical and pharmaceutical products, fertilisers and plastics. According to the WTO Tariff Download Facility, the new duties, i.e. the MFN duties, range from 0.7% to 6.5%. The preferential duties still exclude imports from Russia and Belarus.

The Regulation amends Council Regulation (EU) 2023/2890 of December 2023. According to its text, the objective is "to ensure a sufficient and uninterrupted supply of certain agricultural and industrial products which are not produced in the Union and thereby avoid any disturbances on the market for those products".

The regulation also adds other goods to the list of products with a temporary customs duty suspension (see related intervention).

# paths./api/v2/gta/data/.post.responses.200.content.application/json.examples.FullAccessExample.value.results[].state_act_source[].source
Official Journal of the EU - EUR-Lex (4 July 2024). Council Regulation (EU) 2024/1851 of 25 June 2024 amending Regulation (EU) 2021/2278 suspending the Common Customs Tariff duties referred to in Article 56(2), point (c), of Regulation (EU) No 952/2013 of the European Parliament and of the Council on certain agricultural and industrial products:
https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=OJ:L_202401851

Official Journal of the EU - EUR-Lex (29 December 2023). Council Regulation (EU) 2023/2890 of 19 December 2023 amending Regulation (EU) 2021/2278 suspending the Common Customs Tariff duties referred to in Article 56(2), point (c), of Regulation (EU) No 952/2013 on certain agricultural and industrial products:
https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A32023R2890&qid=1693489952256

WTO Tariff Download Facility. Accessed June 2024: http://tariffdata.wto.org/Default.aspx

# paths./api/v2/gta/data/.post.responses.200.content.application/json.examples.FullAccessExample.value.results[].stated_motive.label[]
Import substitution or protection of domestic industry

# paths./api/v2/gta/data/.post.responses.200.content.application/json.examples.FullAccessExample.value.results[].stated_motive.description
To boost the competitiveness of EU companies and reduce dependence on third countries for the supply of critical raw materials

# paths./api/v2/gta/data/.post.responses.200.content.application/json.examples.FullAccessExample.value.results[].affected_products[].name
Amine-function compounds; aromatic monoamines and their derivatives; salts thereof; n.e.c. in item no. 2921.4

# paths./api/v2/gta/data/.post.responses.200.content.application/json.examples.FullAccessExample.value.results[].affected_products[].name
Amino-naphthols and other amino-phenols, other than those containing more than one kind of oxygen function, their ethers and esters; salts thereof n.e.c. in item no. 2922.2

# paths./api/v2/gta/data/.post.responses.200.content.application/json.examples.FullAccessExample.value.results[].affected_products[].name
Cyclic amides (including cyclic carbamates) and their derivatives; other than the derivatives and salts of ureines, 2-acetamidobenzoic acid (N-acetylanthancillic acid),ethinamate S, and alachlor (ISO) and their derivatives and salts

# paths./api/v2/gta/data/.post.responses.200.content.application/json.examples.FullAccessExample.description
Complete example showing all available fields for full access users

# paths./api/v2/gta/data/.post.responses.200.content.application/json.examples.BasicAccessExample.value.results[].state_act_title
EU: Changes to the list of agricultural and industrial products subject to a reduction of import duties (July 2024)

# paths./api/v2/gta/data/.post.responses.200.content.application/json.examples.BasicAccessExample.value.results[].affected_products[].name
Amine-function compounds; aromatic monoamines and their derivatives; salts thereof; n.e.c. in item no. 2921.4

# paths./api/v2/gta/data/.post.responses.200.content.application/json.examples.BasicAccessExample.value.results[].affected_products[].name
Amino-naphthols and other amino-phenols, other than those containing more than one kind of oxygen function, their ethers and esters; salts thereof n.e.c. in item no. 2922.2

# paths./api/v2/gta/data/.post.responses.200.content.application/json.examples.BasicAccessExample.value.results[].affected_products[].name
Cyclic amides (including cyclic carbamates) and their derivatives; other than the derivatives and salts of ureines, 2-acetamidobenzoic acid (N-acetylanthancillic acid),ethinamate S, and alachlor (ISO) and their derivatives and salts

# paths./api/v2/gta/data/.post.responses.200.content.application/json.examples.BasicAccessExample.description
Simplified example showing essential fields for basic access users

# components.schemas.APIClientUsage.properties.tier.description
Rate-limit tier for this API product. DEMO is quota-limited; UNRESTRICTED bypasses the standard quota.

# components.schemas.APIClientUsage.properties.is_limited.description
Whether standard daily and weekly quota limits apply to this API product.

# components.schemas.APIClientUsage.properties.trial_window.description
Effective trial date window for this product as {"from": ..., "to": ...} ISO dates, or null when the product is not on trial. Data outside this window is unavailable regardless of the requested range.

# components.schemas.APIClientUsage.properties.daily.description
Usage and quota information for the last 24 hours.

# components.schemas.APIClientUsage.properties.weekly.description
Usage and quota information for the last 7 days.

# components.schemas.APIKeyOverview.properties.key_name.description
Optional display name assigned to the API key.

# components.schemas.APIKeyOverview.properties.client_id.description
API product this key is configured for. Typical values are GTA, DPA, or BOS.

# components.schemas.APIKeyOverview.properties.datetime_created.description
ISO 8601 timestamp when this API key was created.

# components.schemas.APIKeyOverview.properties.datetime_expired.description
ISO 8601 timestamp when this API key expires, or null when it does not expire.

# components.schemas.APIUsageBreakdown.properties.gta.description
Usage and quota information for the GTA API product.

# components.schemas.APIUsageBreakdown.properties.dpa.description
Usage and quota information for the DPA API product.

# components.schemas.APIUsageBreakdown.properties.bos.description
Usage and quota information for the BOS API product.

# components.schemas.APIUsageOverview.properties.packages.description
Package codes enabled for the authenticated API account.

# components.schemas.APIUsageOverview.properties.api_updates.description
Whether the account is subscribed to API update notifications.

# components.schemas.APIUsageOverview.properties.api_keys.description
Active, non-expired, non-blocked API keys for the authenticated account.

# components.schemas.APIUsageOverview.properties.usage.description
Per-product API usage and quota information for the authenticated account.

# components.schemas.APIUsageWindow.properties.used.description
Number of API result entries returned during this usage window.

# components.schemas.APIUsageWindow.properties.limit.description
Maximum number of API result entries allowed during this usage window, or null for unlimited tiers.

# components.schemas.APIUsageWindow.properties.remaining.description
Remaining API result entries available during this usage window, or null for unlimited tiers.

# components.schemas.AdvantageResponse.properties.un_code.description
UN M49 country code used by the tariff engine.

# components.schemas.AdvantageResponse.properties.compare_country_un.description
UN M49 country code of the comparison country, or null when comparing against all peers.

# components.schemas.AdvantageResponse.properties.policy_date.description
Policy date used for the tariff calculation or aggregation.

# components.schemas.AdvantageResponse.properties.top_n.description
Maximum number of ranked rows returned by the endpoint.

# components.schemas.AdvantageResponse.properties.rows.description
Aggregate result rows returned by this endpoint.

# components.schemas.AdvantageResponse.properties.avg_own.description
Trade-weighted average own-country rate across returned products.

# components.schemas.AdvantageResponse.properties.avg_peer.description
Trade-weighted average peer rate across returned products.

# components.schemas.AdvantageResponse.properties.avg_advantage_pp.description
Trade-weighted average tariff advantage across returned products.

# components.schemas.AdvantageRow.properties.own_rate.description
Applied tariff rate for the focus country and product.

# components.schemas.AdvantageRow.properties.peer_rate.description
Trade-weighted applied tariff rate for peer countries and the same product.

# components.schemas.AdvantageRow.properties.advantage_pp.description
Peer rate minus own rate, in percentage points.

# components.schemas.AdvantageRow.properties.trade_value_usd.description
Trade value for this flow in US dollars.

# components.schemas.AggregateTimelineResponse.properties.scenario_id.description
Scenario ID used for this calculation or aggregation.

# components.schemas.AggregateTimelineResponse.properties.sample_size.description
Number of top-trade flows sampled for the aggregation.

# components.schemas.AggregateTimelineResponse.properties.flows_used.description
Number of trade flows included in the aggregation after filtering.

# components.schemas.AggregateTimelineResponse.properties.total_trade_bn.description
Total trade value included in the aggregation, in billions of US dollars.

# components.schemas.AggregateTimelineResponse.properties.rows.description
Aggregate result rows returned by this endpoint.

# components.schemas.AggregateTimelineResponse.properties.countries.description
UN M49 country codes included in the aggregation overlay.

# components.schemas.AggregateTimelineRow.properties.policy_date.description
Policy date used for the tariff calculation or aggregation.

# components.schemas.AggregateTimelineRow.properties.avg_rate.description
Trade-weighted average applied tariff rate in percentage points.

# components.schemas.AggregateTimelineRow.properties.avg_hts.description
Trade-weighted average HTS component in percentage points.

# components.schemas.AggregateTimelineRow.properties.avg_ieepa.description
Trade-weighted average IEEPA component in percentage points.

# components.schemas.AggregateTimelineRow.properties.avg_s122.description
Trade-weighted average Section 122 component in percentage points.

# components.schemas.AggregateTimelineRow.properties.avg_s232.description
Trade-weighted average Section 232 component in percentage points.

# components.schemas.AggregateTimelineRow.properties.avg_emergency.description
Trade-weighted average emergency component in percentage points.

# components.schemas.AggregateTimelineRow.properties.avg_s301.description
Trade-weighted average Section 301 component in percentage points.

# components.schemas.AggregateTimelineRow.properties.total_trade_bn.description
Total trade value included in the aggregation, in billions of US dollars.

# components.schemas.AggregateTimelineRow.properties.country_rates.description
Present only when `countries=` is supplied. Maps stringified `un_code` to the country-specific trade-weighted rate.

# components.schemas.CalculationKit.description
The `calculation_kit` payload inside /calculate/single/kit/ responses.

Designed to be self-contained: the kit plus the baseline result lets a
downstream client (LLM, frontend) explain the rate, offer sensitivity
controls, and compute counterfactuals without further API calls.

# components.schemas.CalculationKit.properties.formula_name.description
Short formula identifier: 'HTS + IEEPA + S122 + Emergency + S301' (Formula 3), 'HTS + S232 + Emergency + S301' (Formula 1), etc.

# components.schemas.CalculationKit.properties.formula_description.description
Prose description of when this formula applies.

# components.schemas.CalculationKit.properties.formula_expression_python.description
The Python-syntax formula the engine evaluated. Variables resolve from `fixed_values` and `tunable_parameters`. For client-side what-if analysis, parse with `ast.parse(mode='eval')` and walk the tree, or use a restricted evaluator such as `asteval` or `simpleeval`. Do NOT pass the string directly to `eval()` — treat it as untrusted input.

# components.schemas.CalculationKit.properties.tunable_parameters.description
Parameters clients may vary for what-if analysis.

# components.schemas.CalculationKit.properties.discrete_options.description
Enumerated calculation options clients may vary for what-if analysis.

# components.schemas.CalculationKit.properties.fixed_values.description
Parameter values already resolved by regime/deal logic that are NOT user-tunable for this product-country-date combination.

# components.schemas.CalculationKit.properties.deals_in_force.description
Bilateral deals active for the requested product-country-date combination.

# components.schemas.CalculationKit.properties.negative_list_s301.description
Negative-list Section 301 parameters, this line's carve-out membership, and the carve-out precedence — present only for countries with a negative-list archetype (e.g. Brazil), null otherwise. Lets a client explain exclusions and derive the aircraft rate without any hardcoded figure.

# components.schemas.CalculationKit.properties.artifact_suggestion.description
Hint about what UI affordance best fits this calculation (e.g. 'sensitivity_slider', 'deal_toggle_controls'). Empty if no meaningful affordance applies.

# components.schemas.CalculationKitResponse.description
Full /calculate/single/kit/ response: baseline result + calculation kit.

# components.schemas.CalculationKitResponse.properties.baseline.description
The applied rate result (identical to /calculate/single/ response).

# components.schemas.CalculationKitResponse.properties.calculation_kit.description
Self-contained kit for explaining and interactively exploring the rate.

# components.schemas.CalculationResult.description
Paginated batch calculation response (DRF LimitOffset shape).

# components.schemas.CalculationResult.properties.count.description
Total number of matching product-country calculation rows.

# components.schemas.CalculationResult.properties.next.description
URL for the next page of batch results, or null when there is no next page.

# components.schemas.CalculationResult.properties.previous.description
URL for the previous page of batch results, or null when there is no previous page.

# components.schemas.CalculationResult.properties.filters.description
Reconciliation of requested filter values against those present in the data. Present when hs_8digit was supplied: reports how many codes were requested, how many matched import rows, and names the unmatched ones.

# components.schemas.CalculationResult.properties.results.description
Current page of tariff calculation rows.

# components.schemas.CarveOutPrecedenceStep.description
One step in the negative-list carve-out precedence sequence.

# components.schemas.CarveOutPrecedenceStep.properties.key.description
Carve-out identifier (annex / annex_ex / statutory / chapter_98 / s232_closed_list / annex_aircraft / annex_pharma / s232_metal_split_steel / s232_metal_split_alu / s232_metal_split_copper / semiconductor / plain).

# components.schemas.CarveOutPrecedenceStep.properties.description.description
What this carve-out step does to the rate.

# components.schemas.CountryBriefChapter.properties.avg_rate.description
Trade-weighted average applied tariff rate in percentage points.

# components.schemas.CountryBriefChapter.properties.trade_value_bn.description
Trade value for this aggregate row in billions of US dollars.

# components.schemas.CountryBriefChapter.properties.n_flows.description
Number of trade flows included in this aggregate row.

# components.schemas.CountryBriefProduct.properties.final_rate.description
Final applied tariff rate in percentage points.

# components.schemas.CountryBriefProduct.properties.rate_formula.description
Formula branch used to combine tariff components.

# components.schemas.CountryBriefProduct.properties.trade_value_usd.description
Trade value for this flow in US dollars.

# components.schemas.CountryBriefResponse.properties.un_code.description
UN M49 country code used by the tariff engine.

# components.schemas.CountryBriefResponse.properties.policy_date.description
Policy date used for the tariff calculation or aggregation.

# components.schemas.CountryBriefResponse.properties.total_trade_bn.description
Total trade value included in the aggregation, in billions of US dollars.

# components.schemas.CountryBriefResponse.properties.avg_rate.description
Trade-weighted average applied tariff rate in percentage points.

# components.schemas.CountryBriefResponse.properties.chapters.description
HS2 chapter-level aggregate rows for the country brief.

# components.schemas.CountryBriefResponse.properties.top_products.description
Top HS8 products by exposure for the country brief.

# components.schemas.CountryInfo.properties.un_code.description
UN M49 country code used by the tariff engine.

# components.schemas.CountryInfo.properties.is_ieepa.description
Whether this country is part of an IEEPA country group in the tariff model.

# components.schemas.CountryInfo.properties.is_s232_steel.description
Whether this country is part of the Section 232 steel country group.

# components.schemas.CountryInfo.properties.is_eu_member.description
Whether this country is an EU member state. The Register's Country slice sells the EU as one aggregate origin (the literal token 'EU'), so a member state is not offered separately in the origin picker.

# components.schemas.CountryListResponse.description
Paginated country search response (DRF LimitOffset shape).

# components.schemas.CountryListResponse.properties.count.description
Total number of matching country records.

# components.schemas.CountryListResponse.properties.next.description
URL for the next page of country results, or null when there is no next page.

# components.schemas.CountryListResponse.properties.previous.description
URL for the previous page of country results, or null when there is no previous page.

# components.schemas.CountryListResponse.properties.results.description
Current page of country reference records.

# components.schemas.CountryRankingResponse.properties.policy_date.description
Policy date used for the tariff calculation or aggregation.

# components.schemas.CountryRankingResponse.properties.compare_date.description
Optional comparison date used to calculate rate deltas.

# components.schemas.CountryRankingResponse.properties.top_n.description
Maximum number of ranked rows returned by the endpoint.

# components.schemas.CountryRankingResponse.properties.flows_used.description
Number of trade flows included in the aggregation after filtering.

# components.schemas.CountryRankingResponse.properties.rows.description
Aggregate result rows returned by this endpoint.

# components.schemas.CountryRankingRow.properties.un_code.description
UN M49 country code used by the tariff engine.

# components.schemas.CountryRankingRow.properties.avg_rate.description
Trade-weighted average applied tariff rate in percentage points.

# components.schemas.CountryRankingRow.properties.avg_rate_compare.description
Trade-weighted average applied tariff rate on the comparison date, or null when no comparison date was supplied.

# components.schemas.CountryRankingRow.properties.delta_pp.description
Difference between policy-date and comparison-date rates, in percentage points.

# components.schemas.CountryRankingRow.properties.trade_value_bn.description
Trade value for this aggregate row in billions of US dollars.

# components.schemas.DealInForce.description
One bilateral deal currently in force for the requested product-country-date.

# components.schemas.DealInForce.properties.verbal_spec.description
Plain-English description of how the deal modifies the standard tariff calculation. This is the load-bearing prose for explaining the rate to end users.

# components.schemas.DealInForce.properties.affected_components.description
Which rate components this deal affects (e.g. 's232_rate', 'ieepa_rate'). Empty if the deal only modifies product exceptions.

# components.schemas.DealInForce.properties.counterfactual_final_rate.description
What the final rate would be without this deal in force. Compare to `baseline.final_rate` to measure the deal's impact.

# components.schemas.DealInForce.properties.rate_delta_pp.description
Change in final rate caused by this deal, in percentage points. Negative values indicate the deal reduces the rate.

# components.schemas.DealToggle.properties.deal_name.description
Internal deal identifier. Pass this value to `/deal/toggle/` as `name`.

# components.schemas.DealToggle.properties.is_active.description
Whether this deal is enabled for the selected scenario.

# components.schemas.DealToggle.properties.effective_date.description
Scenario-specific effective date for the deal, or null when the default applies.

# components.schemas.DealToggleList.properties.deals.description
Deal toggle records for the selected scenario.

# components.schemas.DiscreteOption.description
One discrete option in the calculation kit (e.g. annex classification).

# components.schemas.DiscreteOption.properties.value.description
Currently selected discrete option value.

# components.schemas.DiscreteOption.properties.options.description
Allowed values for this discrete option.

# components.schemas.GTACountsRequestBody.description
Request body serializer for GTA data counts endpoint

# components.schemas.GTACountsRequestBody.properties.request_data.description
This parameter accepts an object containing the key-value pairs used as filters.

# components.schemas.GTACountsRequestDataFilters.description
Serializer for GTA data counts request filters

This serializer defines the available filters for querying intervention counts.

# components.schemas.GTACountsRequestDataFilters.properties.keep_affected.description
Boolean filter defining if chosen affected jurisdiction values should be in- or excluded

# components.schemas.GTACountsRequestDataFilters.properties.keep_implementer.description
Boolean filter defining if chosen implementing jurisdiction values should be in- or excluded

# components.schemas.GTACountsRequestDataFilters.properties.keep_intervention_types.description
Boolean filter defining if chosen intervention types should be in- or excluded

# components.schemas.GTACountsRequestDataFilters.properties.keep_mast_chapters.description
Boolean filter defining if chosen MAST chapter values should be in- or excluded

# components.schemas.GTACountsRequestDataFilters.properties.keep_implementation_level.description
Boolean filter defining if chosen implementation level values should be in- or excluded

# components.schemas.GTACountsRequestDataFilters.properties.keep_eligible_firms.description
Boolean filter defining if chosen eligible firms values should be in- or excluded

# components.schemas.GTACountsRequestDataFilters.properties.keep_rationale.description
Boolean filter defining if chosen rationale values should be in- or excluded. Note: The legacy "keep_rationals" parameter name is also supported for backwards compatibility.

# components.schemas.GTACountsRequestDataFilters.properties.implementation_period.description
Date range filter defining when the intervention was implemented. `None` values are treated as unfiltered (=any date into the past or future).

# components.schemas.GTACountsRequestDataFilters.properties.revocation_period.description
Date range filter defining when the intervention was revoked. `None` values are treated as unfiltered (=any date into the past or future).

# components.schemas.GTACountsRequestDataFilters.properties.announcement_period.description
Date range filter defining when the intervention was announced. `None` values are treated as unfiltered (=any date into the past or future).

# components.schemas.GTACountsRequestDataFilters.properties.affected_sectors.description
Filters by a list of CPC sector codes, accepted values are CPC sector codes, multiple possible

# components.schemas.GTACountsRequestDataFilters.properties.keep_affected_sectors.description
Boolean filter defining if chosen CPC sectors should be in- or excluded

# components.schemas.GTACountsRequestDataFilters.properties.affected_products.description
Filters by a list of HS codes, accepted values are HS product codes, multiple possible

# components.schemas.GTACountsRequestDataFilters.properties.keep_affected_products.description
Boolean filter defining if chosen HS codes should be in- or excluded

# components.schemas.GTACountsRequestDataFilters.properties.count_variable.description
Variable to count. Default is `intervention_id`. Accepted values: `intervention_id`, `state_act_id`, `affected_products`, `affected_sectors`

* `intervention_id` - intervention_id
* `state_act_id` - state_act_id
* `affected_products` - affected_products
* `affected_sectors` - affected_sectors

# components.schemas.GTACountsRequestDataFilters.properties.gta_evaluation.items.description
* `1` - Red - Harmful to trade
* `2` - Amber - Murky/unclear impact
* `3` - Green - Liberalizing to trade
* `4` - Harmful - Includes both Red and Amber interventions
* `5` - Liberalizing - Equivalent to Green interventions

# components.schemas.GTACountsRequestDataFilters.properties.gta_evaluation.description
Filters by evaluation value, multiple possible. Values 4 and 5 are conceptual groupings that map to base values 1-3.
1 - Red - Harmful to trade
2 - Amber - Murky/unclear impact
3 - Green - Liberalizing to trade
4 - Harmful - Includes both Red and Amber interventions
5 - Liberalizing - Equivalent to Green interventions

# components.schemas.GTACountsRequestDataFilters.properties.affected_flow.items.description
* `1` - Inward
* `2` - Outward
* `3` - Outward subsidy

# components.schemas.GTACountsRequestDataFilters.properties.affected_flow.description
Filters by affected flow value, multiple possible. Affected flows determine the trade flow, that an intervention affects.
1 - Inward
2 - Outward
3 - Outward subsidy

# components.schemas.GTACountsRequestDataFilters.properties.affected.description
Filters by jurisdictions, accepted values are UN country codes, multiple possible.
4 - Afghanistan
8 - Albania
12 - Algeria
16 - American Samoa
20 - Andorra
24 - Angola
28 - Antigua & Barbuda
31 - Azerbaijan
32 - Argentina
36 - Australia
40 - Austria
44 - Bahamas
48 - Bahrain
50 - Bangladesh
51 - Armenia
52 - Barbados
56 - Belgium
60 - Bermuda
64 - Bhutan
68 - Bolivia
70 - Bosnia & Herzegovina
72 - Botswana
76 - Brazil
84 - Belize
90 - Solomon Islands
92 - British Virgin Islands
96 - Brunei Darussalam
100 - Bulgaria
104 - Myanmar
108 - Burundi
112 - Belarus
116 - Cambodia
120 - Cameroon
124 - Canada
132 - Cape Verde
136 - Cayman Islands
140 - Central African Republic
144 - Sri Lanka
148 - Chad
152 - Chile
156 - China
158 - Chinese Taipei
170 - Colombia
174 - Comoros
175 - Mayotte
178 - Congo
180 - DR Congo
184 - Cook Islands
188 - Costa Rica
191 - Croatia
192 - Cuba
196 - Cyprus
203 - Czechia
204 - Benin
208 - Denmark
212 - Dominica
214 - Dominican Republic
218 - Ecuador
222 - El Salvador
226 - Equatorial Guinea
231 - Ethiopia
232 - Eritrea
233 - Estonia
234 - Faeroe Islands
238 - Falkland Islands
242 - Fiji
246 - Finland
251 - France
254 - French Guiana
258 - French Polynesia
262 - Djibouti
266 - Gabon
268 - Georgia
270 - Gambia
275 - State of Palestine
276 - Germany
288 - Ghana
296 - Kiribati
300 - Greece
304 - Greenland
308 - Grenada
312 - Guadeloupe
316 - Guam
320 - Guatemala
324 - Guinea
328 - Guyana
332 - Haiti
336 - Vatican
340 - Honduras
344 - Hong Kong
348 - Hungary
352 - Iceland
360 - Indonesia
364 - Iran
368 - Iraq
372 - Ireland
376 - Israel
381 - Italy
384 - Ivory Coast
388 - Jamaica
392 - Japan
398 - Kazakhstan
400 - Jordan
404 - Kenya
408 - DPR Korea
410 - Republic of Korea
414 - Kuwait
417 - Kyrgyzstan
418 - Lao
422 - Lebanon
426 - Lesotho
428 - Latvia
430 - Liberia
434 - Libya
438 - Liechtenstein
440 - Lithuania
442 - Luxembourg
446 - Macao
450 - Madagascar
454 - Malawi
458 - Malaysia
462 - Maldives
466 - Mali
470 - Malta
474 - Martinique
478 - Mauritania
480 - Mauritius
484 - Mexico
492 - Monaco
496 - Mongolia
498 - Republic of Moldova
499 - Montenegro
500 - Montserrat
504 - Morocco
508 - Mozambique
512 - Oman
516 - Namibia
520 - Nauru
524 - Nepal
528 - Netherlands
532 - Netherlands Antilles
533 - Aruba
540 - New Caledonia
548 - Vanuatu
554 - New Zealand
558 - Nicaragua
562 - Niger
566 - Nigeria
570 - Niue
574 - Norfolk Island
578 - Norway
580 - Northern Mariana Islands
583 - Micronesia
584 - Marshall Islands
585 - Palau
586 - Pakistan
591 - Panama
598 - Papua New Guinea
600 - Paraguay
604 - Peru
608 - Philippines
612 - Pitcairn
616 - Poland
620 - Portugal
624 - Guinea-Bissau
626 - Timor-Leste
630 - Puerto Rico
634 - Qatar
638 - Réunion
642 - Romania
643 - Russia
646 - Rwanda
652 - Saint-Barthélemy
654 - Saint Helena
659 - Saint Kitts & Nevis
660 - Anguilla
662 - Saint Lucia
663 - Saint-Martin
666 - Saint Pierre & Miquelon
670 - Saint Vincent & the Grenadines
674 - San Marino
678 - Sao Tome & Principe
682 - Saudi Arabia
686 - Senegal
688 - Serbia
690 - Seychelles
694 - Sierra Leone
699 - India
702 - Singapore
703 - Slovakia
704 - Vietnam
705 - Slovenia
706 - Somalia
710 - South Africa
716 - Zimbabwe
724 - Spain
728 - South Sudan
729 - Republic of the Sudan
732 - Western Sahara
740 - Suriname
744 - Svalbard & Jan Mayen Islands
748 - Eswatini
752 - Sweden
756 - Switzerland
760 - Syria
762 - Tajikistan
764 - Thailand
768 - Togo
772 - Tokelau
776 - Tonga
780 - Trinidad & Tobago
784 - United Arab Emirates
788 - Tunisia
792 - Turkiye
795 - Turkmenistan
796 - Turks & Caicos Islands
798 - Tuvalu
800 - Uganda
804 - Ukraine
807 - Macedonia
818 - Egypt
826 - United Kingdom
834 - Tanzania
840 - United States of America
850 - US Virgin Islands
854 - Burkina Faso
858 - Uruguay
860 - Uzbekistan
862 - Venezuela
876 - Wallis & Futuna Islands
882 - Samoa
887 - Yemen
894 - Zambia
999 - Republic of Kosovo

# components.schemas.GTACountsRequestDataFilters.properties.implementer.description
Filters by jurisdictions, accepted values are UN country codes, multiple possible.
4 - Afghanistan
8 - Albania
12 - Algeria
16 - American Samoa
20 - Andorra
24 - Angola
28 - Antigua & Barbuda
31 - Azerbaijan
32 - Argentina
36 - Australia
40 - Austria
44 - Bahamas
48 - Bahrain
50 - Bangladesh
51 - Armenia
52 - Barbados
56 - Belgium
60 - Bermuda
64 - Bhutan
68 - Bolivia
70 - Bosnia & Herzegovina
72 - Botswana
76 - Brazil
84 - Belize
90 - Solomon Islands
92 - British Virgin Islands
96 - Brunei Darussalam
100 - Bulgaria
104 - Myanmar
108 - Burundi
112 - Belarus
116 - Cambodia
120 - Cameroon
124 - Canada
132 - Cape Verde
136 - Cayman Islands
140 - Central African Republic
144 - Sri Lanka
148 - Chad
152 - Chile
156 - China
158 - Chinese Taipei
170 - Colombia
174 - Comoros
175 - Mayotte
178 - Congo
180 - DR Congo
184 - Cook Islands
188 - Costa Rica
191 - Croatia
192 - Cuba
196 - Cyprus
203 - Czechia
204 - Benin
208 - Denmark
212 - Dominica
214 - Dominican Republic
218 - Ecuador
222 - El Salvador
226 - Equatorial Guinea
231 - Ethiopia
232 - Eritrea
233 - Estonia
234 - Faeroe Islands
238 - Falkland Islands
242 - Fiji
246 - Finland
251 - France
254 - French Guiana
258 - French Polynesia
262 - Djibouti
266 - Gabon
268 - Georgia
270 - Gambia
275 - State of Palestine
276 - Germany
288 - Ghana
296 - Kiribati
300 - Greece
304 - Greenland
308 - Grenada
312 - Guadeloupe
316 - Guam
320 - Guatemala
324 - Guinea
328 - Guyana
332 - Haiti
336 - Vatican
340 - Honduras
344 - Hong Kong
348 - Hungary
352 - Iceland
360 - Indonesia
364 - Iran
368 - Iraq
372 - Ireland
376 - Israel
381 - Italy
384 - Ivory Coast
388 - Jamaica
392 - Japan
398 - Kazakhstan
400 - Jordan
404 - Kenya
408 - DPR Korea
410 - Republic of Korea
414 - Kuwait
417 - Kyrgyzstan
418 - Lao
422 - Lebanon
426 - Lesotho
428 - Latvia
430 - Liberia
434 - Libya
438 - Liechtenstein
440 - Lithuania
442 - Luxembourg
446 - Macao
450 - Madagascar
454 - Malawi
458 - Malaysia
462 - Maldives
466 - Mali
470 - Malta
474 - Martinique
478 - Mauritania
480 - Mauritius
484 - Mexico
492 - Monaco
496 - Mongolia
498 - Republic of Moldova
499 - Montenegro
500 - Montserrat
504 - Morocco
508 - Mozambique
512 - Oman
516 - Namibia
520 - Nauru
524 - Nepal
528 - Netherlands
532 - Netherlands Antilles
533 - Aruba
540 - New Caledonia
548 - Vanuatu
554 - New Zealand
558 - Nicaragua
562 - Niger
566 - Nigeria
570 - Niue
574 - Norfolk Island
578 - Norway
580 - Northern Mariana Islands
583 - Micronesia
584 - Marshall Islands
585 - Palau
586 - Pakistan
591 - Panama
598 - Papua New Guinea
600 - Paraguay
604 - Peru
608 - Philippines
612 - Pitcairn
616 - Poland
620 - Portugal
624 - Guinea-Bissau
626 - Timor-Leste
630 - Puerto Rico
634 - Qatar
638 - Réunion
642 - Romania
643 - Russia
646 - Rwanda
652 - Saint-Barthélemy
654 - Saint Helena
659 - Saint Kitts & Nevis
660 - Anguilla
662 - Saint Lucia
663 - Saint-Martin
666 - Saint Pierre & Miquelon
670 - Saint Vincent & the Grenadines
674 - San Marino
678 - Sao Tome & Principe
682 - Saudi Arabia
686 - Senegal
688 - Serbia
690 - Seychelles
694 - Sierra Leone
699 - India
702 - Singapore
703 - Slovakia
704 - Vietnam
705 - Slovenia
706 - Somalia
710 - South Africa
716 - Zimbabwe
724 - Spain
728 - South Sudan
729 - Republic of the Sudan
732 - Western Sahara
740 - Suriname
744 - Svalbard & Jan Mayen Islands
748 - Eswatini
752 - Sweden
756 - Switzerland
760 - Syria
762 - Tajikistan
764 - Thailand
768 - Togo
772 - Tokelau
776 - Tonga
780 - Trinidad & Tobago
784 - United Arab Emirates
788 - Tunisia
792 - Turkiye
795 - Turkmenistan
796 - Turks & Caicos Islands
798 - Tuvalu
800 - Uganda
804 - Ukraine
807 - Macedonia
818 - Egypt
826 - United Kingdom
834 - Tanzania
840 - United States of America
850 - US Virgin Islands
854 - Burkina Faso
858 - Uruguay
860 - Uzbekistan
862 - Venezuela
876 - Wallis & Futuna Islands
882 - Samoa
887 - Yemen
894 - Zambia
999 - Republic of Kosovo

# components.schemas.GTACountsRequestDataFilters.properties.intervention_types.items.description
* `2` - State loan
* `3` - Financial grant
* `4` - In-kind grant
* `5` - Production subsidy
* `6` - Interest payment subsidy
* `7` - Loan guarantee
* `8` - Tax or social insurance relief
* `9` - Competitive devaluation
* `10` - Repatriation & surrender requirements
* `11` - Controls on commercial transactions and investment instruments
* `12` - Controls on credit operations
* `13` - Control on personal transactions
* `14` - Consumption subsidy
* `15` - Tax-based export incentive
* `16` - Export subsidy
* `17` - Other export incentive
* `18` - Export tax
* `19` - Export ban
* `20` - Export tariff quota
* `21` - Export quota
* `22` - Import ban
* `23` - Import incentive
* `24` - Intellectual property protection
* `25` - FDI: Entry and ownership rule
* `26` - FDI: Treatment and operations, nes
* `27` - FDI: Financial incentive
* `28` - Local content requirement
* `29` - Local operations requirement
* `30` - Local labour requirement
* `31` - Labour market access
* `32` - Post-migration treatment
* `33` - Trade payment measure
* `34` - Trade balancing measure
* `35` - Export licensing requirement
* `36` - Import licensing requirement
* `37` - Export-related non-tariff measure, nes
* `38` - Import-related non-tariff measure, nes
* `39` - Foreign customer limit
* `40` - Public procurement preference margin
* `41` - Public procurement localisation
* `42` - Public procurement access
* `43` - Public procurement, nes
* `44` - Import tariff quota
* `45` - Import quota
* `46` - Sanitary and phytosanitary measure
* `47` - Import tariff
* `48` - Internal taxation of imports
* `49` - Technical barrier to trade
* `50` - Import monitoring
* `51` - Anti-dumping
* `52` - Safeguard
* `53` - Anti-subsidy
* `54` - Trade finance
* `55` - Financial assistance in foreign market
* `56` - Anti-circumvention
* `57` - Local content incentive
* `58` - Special safeguard
* `59` - State aid, nes
* `60` - Instrument unclear
* `61` - Price stabilisation
* `62` - State aid, unspecified
* `63` - Local supply requirement for exports
* `64` - Local value added requirement
* `65` - Local value added incentive
* `66` - Local operations incentive
* `67` - Local labour incentive
* `68` - Localisation, nes
* `69` - Voluntary export-restraint arrangements
* `70` - Voluntary export-price restraints
* `71` - Minimum import price (absolute floor)
* `72` - Minimum import price (tariff-based)
* `73` - Other import charges
* `74` - Export price benchmark
* `75` - Port restriction
* `76` - Selective import channel restriction
* `77` - Distribution restriction
* `78` - Post-sales service restriction (MAST Chapter K1)
* `79` - Corporate control order
* `80` - Debt purchase
* `81` - Equity stake
* `82` - Financial investment support
* `83` - Lending support

# components.schemas.GTACountsRequestDataFilters.properties.intervention_types.description
Filters by a list of intervention types directly, multiple possible.
2 - State loan
3 - Financial grant
4 - In-kind grant
5 - Production subsidy
6 - Interest payment subsidy
7 - Loan guarantee
8 - Tax or social insurance relief
9 - Competitive devaluation
10 - Repatriation & surrender requirements
11 - Controls on commercial transactions and investment instruments
12 - Controls on credit operations
13 - Control on personal transactions
14 - Consumption subsidy
15 - Tax-based export incentive
16 - Export subsidy
17 - Other export incentive
18 - Export tax
19 - Export ban
20 - Export tariff quota
21 - Export quota
22 - Import ban
23 - Import incentive
24 - Intellectual property protection
25 - FDI: Entry and ownership rule
26 - FDI: Treatment and operations, nes
27 - FDI: Financial incentive
28 - Local content requirement
29 - Local operations requirement
30 - Local labour requirement
31 - Labour market access
32 - Post-migration treatment
33 - Trade payment measure
34 - Trade balancing measure
35 - Export licensing requirement
36 - Import licensing requirement
37 - Export-related non-tariff measure, nes
38 - Import-related non-tariff measure, nes
39 - Foreign customer limit
40 - Public procurement preference margin
41 - Public procurement localisation
42 - Public procurement access
43 - Public procurement, nes
44 - Import tariff quota
45 - Import quota
46 - Sanitary and phytosanitary measure
47 - Import tariff
48 - Internal taxation of imports
49 - Technical barrier to trade
50 - Import monitoring
51 - Anti-dumping
52 - Safeguard
53 - Anti-subsidy
54 - Trade finance
55 - Financial assistance in foreign market
56 - Anti-circumvention
57 - Local content incentive
58 - Special safeguard
59 - State aid, nes
60 - Instrument unclear
61 - Price stabilisation
62 - State aid, unspecified
63 - Local supply requirement for exports
64 - Local value added requirement
65 - Local value added incentive
66 - Local operations incentive
67 - Local labour incentive
68 - Localisation, nes
69 - Voluntary export-restraint arrangements
70 - Voluntary export-price restraints
71 - Minimum import price (absolute floor)
72 - Minimum import price (tariff-based)
73 - Other import charges
74 - Export price benchmark
75 - Port restriction
76 - Selective import channel restriction
77 - Distribution restriction
78 - Post-sales service restriction (MAST Chapter K1)
79 - Corporate control order
80 - Debt purchase
81 - Equity stake
82 - Financial investment support
83 - Lending support

# components.schemas.GTACountsRequestDataFilters.properties.mast_chapters.items.description
* `1` - A: Sanitary and phytosanitary measure
* `2` - B: Technical barriers to trade
* `3` - Capital control measures
* `4` - D: Contingent trade-protective measures
* `5` - E: Non-automatic licensing, quotas etc.
* `6` - F: Price-control measures, including additional taxes and charges
* `7` - FDI measures
* `8` - G: Finance measures
* `9` - I: Trade-related investment measures
* `10` - L: Subsidies (excl. export subsidies)
* `11` - M: Government procurement restrictions
* `12` - Migration measures
* `13` - N: Intellectual Property
* `14` - P: Export-related measures (incl. subsidies)
* `15` - Tariff measures
* `16` - Instrument unclear
* `17` - C: Pre-shipment inspection and other formalities
* `18` - H: Measures affecting competition
* `19` - J: Distribution restrictions
* `20` - K: Restrictions on post-sales services

# components.schemas.GTACountsRequestDataFilters.properties.mast_chapters.description
Filters by a list of MAST chapters, multiple possible.
1 - A: Sanitary and phytosanitary measure
2 - B: Technical barriers to trade
3 - Capital control measures
4 - D: Contingent trade-protective measures
5 - E: Non-automatic licensing, quotas etc.
6 - F: Price-control measures, including additional taxes and charges
7 - FDI measures
8 - G: Finance measures
9 - I: Trade-related investment measures
10 - L: Subsidies (excl. export subsidies)
11 - M: Government procurement restrictions
12 - Migration measures
13 - N: Intellectual Property
14 - P: Export-related measures (incl. subsidies)
15 - Tariff measures
16 - Instrument unclear
17 - C: Pre-shipment inspection and other formalities
18 - H: Measures affecting competition
19 - J: Distribution restrictions
20 - K: Restrictions on post-sales services

# components.schemas.GTACountsRequestDataFilters.properties.implementation_level.description
Filters by a list of implementation levels, multiple possible.
1 - Supranational
2 - National
3 - Subnational
4 - SEZ
5 - IFI
6 - NFI

# components.schemas.GTACountsRequestDataFilters.properties.eligible_firms.items.description
* `1` - all
* `2` - SMEs
* `3` - firm-specific
* `4` - state-controlled
* `5` - state trading enterprise
* `6` - sector-specific
* `7` - location-specific
* `8` - processing trade

# components.schemas.GTACountsRequestDataFilters.properties.eligible_firms.description
Filters by a list of eligible firm types, multiple possible.
1 - all
2 - SMEs
3 - firm-specific
4 - state-controlled
5 - state trading enterprise
6 - sector-specific
7 - location-specific
8 - processing trade

# components.schemas.GTACountsRequestDataFilters.properties.rationale.description
Filters interventions by rationale. Accepted is a list of rationale IDs, multiple possible. Note: The legacy "rationals" and "keep_rationals" parameter names are still supported for backwards compatibility.

# components.schemas.GTACountsResponse.properties.results.description
List of count results grouped by the specified dimensions

# components.schemas.GTACountsResponseItem.description
Serializer for a single count result item

# components.schemas.GTACountsResponseItem.properties.value_display.description
Display value (same as value for counts)

# components.schemas.GTAMappingAffectedFlowItem.properties.affected_flow_id.description
Affected-flow ID to use in GTA API filters.

# components.schemas.GTAMappingEligibleFirmItem.properties.eligible_firm_id.description
Eligible-firm ID to use in GTA API filters.

# components.schemas.GTAMappingEligibleFirmItem.properties.eligible_firm_description.description
Plain-language description of the eligible-firm category.

# components.schemas.GTAMappingEvaluationItem.properties.gta_evaluation_id.description
GTA evaluation ID to use in GTA API filters.

# components.schemas.GTAMappingImplementationLevelItem.properties.implementation_level_id.description
Implementation-level ID to use in GTA API filters.

# components.schemas.GTAMappingImplementationLevelItem.properties.implementation_level_description.description
Plain-language description of the implementation level.

# components.schemas.GTAMappingInterventionTypeItem.properties.intervention_type_id.description
Intervention type ID to use in GTA API filters.

# components.schemas.GTAMappingInterventionTypeItem.properties.intervention_type_name_short.description
Short display name for the intervention type.

# components.schemas.GTAMappingInterventionTypeItem.properties.intervention_type_description.description
Plain-language description of the intervention type.

# components.schemas.GTAMappingJurisdictionItem.properties.id.description
Jurisdiction ID to use in GTA API filters.

# components.schemas.GTAMappingJurisdictionItem.properties.type.description
Location type. For public GTA mappings this is usually `country`.

# components.schemas.GTAMappingMastChapterItem.properties.id.description
MAST chapter ID to use in GTA API filters.

# components.schemas.GTAMappingMastChapterItem.properties.description.description
Plain-language description of the MAST chapter.

# components.schemas.GTAMappingMastChapterItem.properties.name_clean.description
Normalized MAST chapter name for display/search.

# components.schemas.GTAMappingMastSubchapterItem.properties.id.description
MAST subchapter ID to use in GTA API filters.

# components.schemas.GTAMappingMastSubchapterItem.properties.description.description
Plain-language description of the MAST subchapter.

# components.schemas.GTAMappingRequestBody.properties.keys.description
Define the parameters you would like to get the mappings to output to, choices are `jurisdictions`, `evaluations`, `affected_flows`, `intervention_types`, `mast_chapters`, `mast_subchapters`, `eligible_firms`, `implementation_levels`, `threads`.

# components.schemas.GTAMappingResponse.properties.jurisdictions.description
Jurisdictions available for GTA filters.

# components.schemas.GTAMappingResponse.properties.evaluations.description
GTA evaluation categories available for GTA filters.

# components.schemas.GTAMappingResponse.properties.affected_flows.description
Affected commercial-flow categories available for GTA filters.

# components.schemas.GTAMappingResponse.properties.intervention_types.description
Intervention types available for GTA filters.

# components.schemas.GTAMappingResponse.properties.mast_chapters.description
MAST chapter mappings available for GTA filters.

# components.schemas.GTAMappingResponse.properties.mast_subchapters.description
MAST subchapter mappings available for GTA filters.

# components.schemas.GTAMappingResponse.properties.eligible_firms.description
Eligible-firm categories available for GTA filters.

# components.schemas.GTAMappingResponse.properties.implementation_levels.description
Implementation levels available for GTA filters.

# components.schemas.GTAMappingResponse.properties.threads.description
Public thematic threads available for GTA filters.

# components.schemas.GTAMappingThreadItem.properties.description.description
Plain-language description of the thread.

# components.schemas.GTAMappingThreadItem.properties.date_published.description
Date and time when the thread became public.

# components.schemas.GTAMappingThreadItem.properties.last_updated.description
Date and time when the thread was last updated.

# components.schemas.GTASemanticSearchResponse.properties.results.description
Ranked semantic-search matches returned by the RAG backend.

# components.schemas.GTASemanticSearchResponse.properties.total.description
Total number of matches returned for the query.

# components.schemas.GTASemanticSearchResponse.properties.query.description
Natural-language query that was executed.

# components.schemas.GTASemanticSearchResult.properties.intervention_id.description
Unique identifier of the matched GTA intervention.

# components.schemas.GTASemanticSearchResult.properties.blurb.description
Short matched excerpt or summary returned by the RAG backend.

# components.schemas.GTASemanticSearchResult.properties.score.description
Semantic similarity score assigned by the RAG backend; higher values indicate a stronger match.

# components.schemas.GTASemanticSearchResult.properties.url.description
Relative or absolute URL for the matched GTA intervention.

# components.schemas.GTASemanticSearchResult.properties.publication_date.description
Publication date of the matched intervention as returned by the RAG backend.

# components.schemas.ImpactChainJurisdiction.properties.iso.description
ISO 3166-1 alpha-3 country code for the jurisdiction.

# components.schemas.ImpactChainProductList.properties.intervention_id.description
Unique identifier of the GTA intervention.

# components.schemas.ImpactChainProductList.properties.affected_product.description
HS product affected by this impact chain.

# components.schemas.ImpactChainProductList.properties.implementing_jurisdiction.description
Jurisdiction implementing the policy in this impact chain.

# components.schemas.ImpactChainProductList.properties.affected_jurisdictions.description
Jurisdictions affected by this impact chain.

# components.schemas.ImpactChainProductList.properties.date_implemented.description
Date this product-level impact chain entered into force.

# components.schemas.ImpactChainProductList.properties.date_removed.description
Date this product-level impact chain was removed, or null if it has not been removed.

# components.schemas.ImpactChainProductList.properties.prior_level.description
Policy level before this intervention, or null if not recorded. Rendered as "RangeMinMax: [min]/[max]" when only ranged tariff lines are recorded.

# components.schemas.ImpactChainProductList.properties.new_level.description
Policy level introduced by this intervention, or null if not recorded. Rendered as "RangeMinMax: [min]/[max]" when only ranged tariff lines are recorded.

# components.schemas.ImpactChainProductList.properties.unit.description
Unit of the prior/new policy levels, or null if not recorded.

# components.schemas.ImpactChainRequestBody.description
Reusable serializer for impact chain API request body

# components.schemas.ImpactChainRequestBody.properties.limit.description
Set the size of the result set here. Accepted is any number between 0 and 1000.

# components.schemas.ImpactChainRequestBody.properties.offset.description
Use this parameter to paginate through the output, it accepts any number.

# components.schemas.ImpactChainRequestBody.properties.sorting.description
Comma-separated list of fields to sort by. Prefix with `-` for descending order, e.g. `-date_implemented,intervention_id`. Sorting is validated against the allowed fields for this endpoint.

# components.schemas.ImpactChainRequestBody.properties.request_data.description
This parameter accepts an object containing the key-value pairs used as filters.

# components.schemas.ImpactChainSectorList.properties.intervention_id.description
Unique identifier of the GTA intervention.

# components.schemas.ImpactChainSectorList.properties.affected_sector.description
CPC sector affected by this impact chain.

# components.schemas.ImpactChainSectorList.properties.implementing_jurisdiction.description
Jurisdiction implementing the policy in this impact chain.

# components.schemas.ImpactChainSectorList.properties.affected_jurisdictions.description
Jurisdictions affected by this impact chain.

# components.schemas.ImpactChainSectorList.properties.date_implemented.description
Date this sector-level impact chain entered into force.

# components.schemas.ImpactChainSectorList.properties.date_removed.description
Date this sector-level impact chain was removed, or null if it has not been removed.

# components.schemas.InterventionDescription.properties.status.description
Lifecycle status of this description entry. Values are returned in lowercase, for example `new`, `changed`, or `static`.

# components.schemas.InterventionDescription.properties.order_nr.description
Display order of this description entry within the intervention description history.

# components.schemas.InterventionDescription.properties.modified.description
Timestamp when this description entry was last modified, formatted as `YYYY-MM-DD HH:MM`, or null when unavailable.

# components.schemas.InterventionDescription.properties.text.description
Description text in the requested text format.

# components.schemas.InterventionFullListPublicSerializerV2.description
Used in Public API V2.
V2 Changes: intervention_description and state_act_source should be outputted as
            array of description and source entries respectively.

intervention_description: [
    {
        "status": "existing", // lowercase status
        "order_nr": 1,
        "modified": "2025-01-01 12:23",
        "text": "Description text"
    },
]

state_act_source: [
    {
        "status": "new", // lowercase status
        "order_nr": 1,
        "modified": "2025-01-01 12:23",
        "text": "Source text"
    },
]

# components.schemas.InterventionFullListPublicSerializerV2.properties.intervention_id.description
Unique identifier of the GTA intervention.

# components.schemas.InterventionFullListPublicSerializerV2.properties.state_act_id.description
Unique identifier of the parent state act.

# components.schemas.InterventionFullListPublicSerializerV2.properties.intervention_description.description
Description entries associated with the intervention.

# components.schemas.InterventionFullListPublicSerializerV2.properties.state_act_url.description
Public GTA URL for the parent state act.

# components.schemas.InterventionFullListPublicSerializerV2.properties.state_act_source.description
Source entries associated with the state act.

# components.schemas.InterventionFullListPublicSerializerV2.properties.is_official_source.description
Whether the state act source is official.

# components.schemas.InterventionFullListPublicSerializerV2.properties.gta_evaluation.description
GTA evaluation category assigned to the intervention or state act.

# components.schemas.InterventionFullListPublicSerializerV2.properties.implementing_jurisdiction_groups.description
Jurisdiction groups implementing the policy.

# components.schemas.InterventionFullListPublicSerializerV2.properties.inferred_jurisdictions.description
How affected jurisdictions were inferred for the intervention.

# components.schemas.InterventionFullListPublicSerializerV2.properties.implementation_level.description
Administrative level at which the policy is implemented.

# components.schemas.InterventionFullListPublicSerializerV2.properties.eligible_firm.description
Eligible firm category for the intervention.

# components.schemas.InterventionFullListPublicSerializerV2.properties.affected_products.description
HS product codes affected by the policy.

# components.schemas.InterventionFullListPublicSerializerV2.properties.date_published.description
Date the policy was published in the database.

# components.schemas.InterventionFullListPublicSerializerV2.properties.date_removed.description
Date the policy was removed, or null if it has not been removed.

# components.schemas.InterventionFullListPublicSerializerV2.properties.is_in_force.description
Whether the policy is currently in force. Values are 1 for in force and 0 for not in force.

# components.schemas.InterventionRequestBodyV2.description
Reusable serializer for intervention API request body

# components.schemas.InterventionRequestBodyV2.properties.limit.description
Set the size of the result set here. Accepted is any number between 0 and 1000.

# components.schemas.InterventionRequestBodyV2.properties.offset.description
Use this parameter to paginate through the output, it accepts any number.

# components.schemas.InterventionRequestBodyV2.properties.sorting.description
Define the parameters you would like to sort the output by, accepted are `date_announced`, `date_published`, `date_implemented`, `date_removed`, `intervention_id`, `last_updated`, `latest_action_date`, `last_edited`. Combine multiple order clauses together in the same string by separating them via a comma, e.g. `date_announced,date_implemented`. Reverse the order by adding a `-` in front of the order clause you want to reverse, e.g. `-date_announced`.

# components.schemas.InterventionRequestBodyV2.properties.show_full_names.description
Boolean filter defining if product and sector names should be outputted in full. Per default these values are truncated to 20 characters, in order to reduce the result size.

# components.schemas.InterventionRequestBodyV2.properties.show_keys.description
List of keys to show in the output. If not provided, all keys will be shown.

# components.schemas.InterventionRequestBodyV2.properties.text_format.description
Specify the format for text fields (description, source, stated_motive). Accepts "html" (default) or "markdown".

* `html` - html
* `markdown` - markdown

# components.schemas.InterventionRequestBodyV2.properties.request_data.description
This parameter accepts an object containing the key-value pairs used as filters.

# components.schemas.InterventionRequestDataFiltersV2.description
Serializer for intervention request data filters

To customize which choice fields to include, override selected_fields:
    class CustomSerializer(InterventionRequestDataFiltersV2Serializer):
        selected_fields = ['gta_evaluation', 'affected_flow']

By default, includes all GTA choice fields.

# components.schemas.InterventionRequestDataFiltersV2.properties.keep_affected.description
Boolean filter defining if chosen commercial flow values should be in- or excluded

# components.schemas.InterventionRequestDataFiltersV2.properties.keep_implementer.description
Boolean filter defining if chosen implementing jurisdiction values should be in- or excluded

# components.schemas.InterventionRequestDataFiltersV2.properties.keep_intervention_types.description
Boolean filter defining if chosen intervention types should be in- or excluded

# components.schemas.InterventionRequestDataFiltersV2.properties.keep_mast_chapters.description
Boolean filter defining if chosen mast chapter values should be in- or excluded

# components.schemas.InterventionRequestDataFiltersV2.properties.keep_implementation_level.description
Boolean filter defining if chosen implementation levels values should be in- or excluded

# components.schemas.InterventionRequestDataFiltersV2.properties.keep_eligible_firms.description
Boolean filter defining if chosen eligible firms values should be in- or excluded

# components.schemas.InterventionRequestDataFiltersV2.properties.rationale.description
Filters by a list of rationale IDs, accepted values are rationale IDs from the rationale list, multiple possible

# components.schemas.InterventionRequestDataFiltersV2.properties.keep_rationale.description
Boolean filter defining if chosen rationale values should be in- or excluded. Note: The legacy "keep_rationals" parameter name is also supported for backwards compatibility.

# components.schemas.InterventionRequestDataFiltersV2.properties.announcement_period.description
Daterange filter defining in which range the intervention was announced. `None` values are treated as unfiltered (=any date into the past or future).

# components.schemas.InterventionRequestDataFiltersV2.properties.implementation_period.description
Daterange filter defining in which range the intervention was implemented. `None` values are treated as unfiltered (=any date into the past or future).

# components.schemas.InterventionRequestDataFiltersV2.properties.keep_implementation_period_na.description
Boolean filter defining if interventions with no implementation date should be in- or excluded

# components.schemas.InterventionRequestDataFiltersV2.properties.revocation_period.description
Daterange filter defining in which range the intervention was revoked. `None` values are treated as unfiltered (=any date into the past or future).

# components.schemas.InterventionRequestDataFiltersV2.properties.keep_revocation_na.description
Boolean filter defining if interventions with no revocation date should be in- or excluded

# components.schemas.InterventionRequestDataFiltersV2.properties.submission_period.description
Daterange filter defining in which range the intervention was published. `None` values are treated as unfiltered (=any date into the past or future).

# components.schemas.InterventionRequestDataFiltersV2.properties.update_period.description
Daterange filter defining in which range the intervention was last updated. If no update has been added to an intervention yet, the last update date is equal to the publishing date. None values are treated as unfiltered (=any date into the past or future).

# components.schemas.InterventionRequestDataFiltersV2.properties.last_edited_period.description
Daterange filter defining in which range the intervention was last edited. `None` values are treated as unfiltered (=any date into the past or future).

# components.schemas.InterventionRequestDataFiltersV2.properties.latest_action_period.description
Daterange filter defining in which range the latest action for that intervention has taken place. None values are treated as unfiltered (=any date into the past or future).

# components.schemas.InterventionRequestDataFiltersV2.properties.in_force_on_date.description
A single datestring value defining a date on which the intervention was in force.

# components.schemas.InterventionRequestDataFiltersV2.properties.keep_in_force_on_date.description
Boolean filter defining if interventions that were in force on that date should be in- or excluded

# components.schemas.InterventionRequestDataFiltersV2.properties.affected_sectors.description
Filters by a list of CPC sector codes, accepted values are CPC sector codes, multiple possible

# components.schemas.InterventionRequestDataFiltersV2.properties.keep_affected_sectors.description
Boolean filter defining if chosen CPC sectors should be in- or excluded

# components.schemas.InterventionRequestDataFiltersV2.properties.affected_products.description
Filters by a list of HS codes, accepted values are HS product codes, multiple possible

# components.schemas.InterventionRequestDataFiltersV2.properties.keep_affected_products.description
Boolean filter defining if chosen hs codes should be in- or excluded

# components.schemas.InterventionRequestDataFiltersV2.properties.intervention_id.description
Filters by a list of intervention_ids directly, multiple possible

# components.schemas.InterventionRequestDataFiltersV2.properties.keep_intervention_id.description
Boolean filter defining if chosen intervention ids should be in- or excluded

# components.schemas.InterventionRequestDataFiltersV2.properties.state_act_id.description
Filters by a list of state_act_ids directly, multiple possible

# components.schemas.InterventionRequestDataFiltersV2.properties.keep_state_act_id.description
Boolean filter defining if chosen state act ids should be in- or excluded

# components.schemas.InterventionRequestDataFiltersV2.properties.thread.description
Filters by a list of thread ids, multiple possible. Thread IDs can be fetched via the `/gta/mappings/` endpoint using the `threads` key.

# components.schemas.InterventionRequestDataFiltersV2.properties.keep_thread.description
Boolean filter defining if chosen threads should be in- or excluded

# components.schemas.InterventionRequestDataFiltersV2.properties.lag_adjustment.description
Datestring that filters interventions based on a lag date. Interventions with publishing date after the yearly lag date are excluded. The year component of this datevalue is ignored.

# components.schemas.InterventionRequestDataFiltersV2.properties.query.description
Search for a single word:

**Exact match**: searching for a single word, the feature matches the word as it is, the result will show you all provisions including the exact word. For example, searching for “WTO”, the result will show provisions containing “WTO”.
**Use '#' for various spelling and space**: You can use '#' to enable different spelling variations and spaces. For example, "utili#ation" will show results for either "utilization" or "utilisation." Other symbols in the searched single word will be ignored. For example, searching for “non-tariff”, or “non+tariff”, or “non*tariff”, the result will be the same as searching for “non#tariff”.

Search for a word combination, such as a phrase:

**Exact match**: The feature matches the whole phrase as it is. For example, searching for "electronic commerce" will show the all the provisions containing “electronic commerce” (exact match).
**Exact and partial match**: You can use '#' to enable different spelling variations and spaces. For example, "utili#ation" will show results for either "utilization" or "utilisation."
**Use '|' for "or" logic**: You can use '|' to match either of the provided options. For example, "goods | services" will match with either "goods" or "services"
**Use '&' for "and" logic**: You can use '&' to match sentences that include both sets of options. For example, "technologies & sustainable development" will match all provisions that contain "technologies" and "sustainable development".
**Use '(...)' for "condition hierarchy" logic**: You can use '()' to define a hierarchy in case of multiple or/and conditions. For example, "(goods | services) & (technologies | sustainable development)" will match all provisions that contain "goods" or "service", and "technologies" or "sustainable development".

# components.schemas.InterventionRequestDataFiltersV2.properties.q.description
Alias of `query`. Use `q` or `query` for keyword search. Both are accepted.

# components.schemas.InterventionRequestDataFiltersV2.properties.gta_evaluation.items.description
* `1` - Red - Harmful to trade
* `2` - Amber - Murky/unclear impact
* `3` - Green - Liberalizing to trade
* `4` - Harmful - Includes both Red and Amber interventions
* `5` - Liberalizing - Equivalent to Green interventions

# components.schemas.InterventionRequestDataFiltersV2.properties.gta_evaluation.description
Filters by evaluation value, multiple possible. Values 4 and 5 are conceptual groupings that map to base values 1-3.
1 - Red - Harmful to trade
2 - Amber - Murky/unclear impact
3 - Green - Liberalizing to trade
4 - Harmful - Includes both Red and Amber interventions
5 - Liberalizing - Equivalent to Green interventions

# components.schemas.InterventionRequestDataFiltersV2.properties.affected_flow.items.description
* `1` - Inward
* `2` - Outward
* `3` - Outward subsidy

# components.schemas.InterventionRequestDataFiltersV2.properties.affected_flow.description
Filters by affected flow value, multiple possible. Affected flows determine the trade flow, that an intervention affects.
1 - Inward
2 - Outward
3 - Outward subsidy

# components.schemas.InterventionRequestDataFiltersV2.properties.affected.description
Filters by jurisdictions, accepted values are UN country codes, multiple possible.
4 - Afghanistan
8 - Albania
12 - Algeria
16 - American Samoa
20 - Andorra
24 - Angola
28 - Antigua & Barbuda
31 - Azerbaijan
32 - Argentina
36 - Australia
40 - Austria
44 - Bahamas
48 - Bahrain
50 - Bangladesh
51 - Armenia
52 - Barbados
56 - Belgium
60 - Bermuda
64 - Bhutan
68 - Bolivia
70 - Bosnia & Herzegovina
72 - Botswana
76 - Brazil
84 - Belize
90 - Solomon Islands
92 - British Virgin Islands
96 - Brunei Darussalam
100 - Bulgaria
104 - Myanmar
108 - Burundi
112 - Belarus
116 - Cambodia
120 - Cameroon
124 - Canada
132 - Cape Verde
136 - Cayman Islands
140 - Central African Republic
144 - Sri Lanka
148 - Chad
152 - Chile
156 - China
158 - Chinese Taipei
170 - Colombia
174 - Comoros
175 - Mayotte
178 - Congo
180 - DR Congo
184 - Cook Islands
188 - Costa Rica
191 - Croatia
192 - Cuba
196 - Cyprus
203 - Czechia
204 - Benin
208 - Denmark
212 - Dominica
214 - Dominican Republic
218 - Ecuador
222 - El Salvador
226 - Equatorial Guinea
231 - Ethiopia
232 - Eritrea
233 - Estonia
234 - Faeroe Islands
238 - Falkland Islands
242 - Fiji
246 - Finland
251 - France
254 - French Guiana
258 - French Polynesia
262 - Djibouti
266 - Gabon
268 - Georgia
270 - Gambia
275 - State of Palestine
276 - Germany
288 - Ghana
296 - Kiribati
300 - Greece
304 - Greenland
308 - Grenada
312 - Guadeloupe
316 - Guam
320 - Guatemala
324 - Guinea
328 - Guyana
332 - Haiti
336 - Vatican
340 - Honduras
344 - Hong Kong
348 - Hungary
352 - Iceland
360 - Indonesia
364 - Iran
368 - Iraq
372 - Ireland
376 - Israel
381 - Italy
384 - Ivory Coast
388 - Jamaica
392 - Japan
398 - Kazakhstan
400 - Jordan
404 - Kenya
408 - DPR Korea
410 - Republic of Korea
414 - Kuwait
417 - Kyrgyzstan
418 - Lao
422 - Lebanon
426 - Lesotho
428 - Latvia
430 - Liberia
434 - Libya
438 - Liechtenstein
440 - Lithuania
442 - Luxembourg
446 - Macao
450 - Madagascar
454 - Malawi
458 - Malaysia
462 - Maldives
466 - Mali
470 - Malta
474 - Martinique
478 - Mauritania
480 - Mauritius
484 - Mexico
492 - Monaco
496 - Mongolia
498 - Republic of Moldova
499 - Montenegro
500 - Montserrat
504 - Morocco
508 - Mozambique
512 - Oman
516 - Namibia
520 - Nauru
524 - Nepal
528 - Netherlands
532 - Netherlands Antilles
533 - Aruba
540 - New Caledonia
548 - Vanuatu
554 - New Zealand
558 - Nicaragua
562 - Niger
566 - Nigeria
570 - Niue
574 - Norfolk Island
578 - Norway
580 - Northern Mariana Islands
583 - Micronesia
584 - Marshall Islands
585 - Palau
586 - Pakistan
591 - Panama
598 - Papua New Guinea
600 - Paraguay
604 - Peru
608 - Philippines
612 - Pitcairn
616 - Poland
620 - Portugal
624 - Guinea-Bissau
626 - Timor-Leste
630 - Puerto Rico
634 - Qatar
638 - Réunion
642 - Romania
643 - Russia
646 - Rwanda
652 - Saint-Barthélemy
654 - Saint Helena
659 - Saint Kitts & Nevis
660 - Anguilla
662 - Saint Lucia
663 - Saint-Martin
666 - Saint Pierre & Miquelon
670 - Saint Vincent & the Grenadines
674 - San Marino
678 - Sao Tome & Principe
682 - Saudi Arabia
686 - Senegal
688 - Serbia
690 - Seychelles
694 - Sierra Leone
699 - India
702 - Singapore
703 - Slovakia
704 - Vietnam
705 - Slovenia
706 - Somalia
710 - South Africa
716 - Zimbabwe
724 - Spain
728 - South Sudan
729 - Republic of the Sudan
732 - Western Sahara
740 - Suriname
744 - Svalbard & Jan Mayen Islands
748 - Eswatini
752 - Sweden
756 - Switzerland
760 - Syria
762 - Tajikistan
764 - Thailand
768 - Togo
772 - Tokelau
776 - Tonga
780 - Trinidad & Tobago
784 - United Arab Emirates
788 - Tunisia
792 - Turkiye
795 - Turkmenistan
796 - Turks & Caicos Islands
798 - Tuvalu
800 - Uganda
804 - Ukraine
807 - Macedonia
818 - Egypt
826 - United Kingdom
834 - Tanzania
840 - United States of America
850 - US Virgin Islands
854 - Burkina Faso
858 - Uruguay
860 - Uzbekistan
862 - Venezuela
876 - Wallis & Futuna Islands
882 - Samoa
887 - Yemen
894 - Zambia
999 - Republic of Kosovo

# components.schemas.InterventionRequestDataFiltersV2.properties.implementer.description
Filters by jurisdictions, accepted values are UN country codes, multiple possible.
4 - Afghanistan
8 - Albania
12 - Algeria
16 - American Samoa
20 - Andorra
24 - Angola
28 - Antigua & Barbuda
31 - Azerbaijan
32 - Argentina
36 - Australia
40 - Austria
44 - Bahamas
48 - Bahrain
50 - Bangladesh
51 - Armenia
52 - Barbados
56 - Belgium
60 - Bermuda
64 - Bhutan
68 - Bolivia
70 - Bosnia & Herzegovina
72 - Botswana
76 - Brazil
84 - Belize
90 - Solomon Islands
92 - British Virgin Islands
96 - Brunei Darussalam
100 - Bulgaria
104 - Myanmar
108 - Burundi
112 - Belarus
116 - Cambodia
120 - Cameroon
124 - Canada
132 - Cape Verde
136 - Cayman Islands
140 - Central African Republic
144 - Sri Lanka
148 - Chad
152 - Chile
156 - China
158 - Chinese Taipei
170 - Colombia
174 - Comoros
175 - Mayotte
178 - Congo
180 - DR Congo
184 - Cook Islands
188 - Costa Rica
191 - Croatia
192 - Cuba
196 - Cyprus
203 - Czechia
204 - Benin
208 - Denmark
212 - Dominica
214 - Dominican Republic
218 - Ecuador
222 - El Salvador
226 - Equatorial Guinea
231 - Ethiopia
232 - Eritrea
233 - Estonia
234 - Faeroe Islands
238 - Falkland Islands
242 - Fiji
246 - Finland
251 - France
254 - French Guiana
258 - French Polynesia
262 - Djibouti
266 - Gabon
268 - Georgia
270 - Gambia
275 - State of Palestine
276 - Germany
288 - Ghana
296 - Kiribati
300 - Greece
304 - Greenland
308 - Grenada
312 - Guadeloupe
316 - Guam
320 - Guatemala
324 - Guinea
328 - Guyana
332 - Haiti
336 - Vatican
340 - Honduras
344 - Hong Kong
348 - Hungary
352 - Iceland
360 - Indonesia
364 - Iran
368 - Iraq
372 - Ireland
376 - Israel
381 - Italy
384 - Ivory Coast
388 - Jamaica
392 - Japan
398 - Kazakhstan
400 - Jordan
404 - Kenya
408 - DPR Korea
410 - Republic of Korea
414 - Kuwait
417 - Kyrgyzstan
418 - Lao
422 - Lebanon
426 - Lesotho
428 - Latvia
430 - Liberia
434 - Libya
438 - Liechtenstein
440 - Lithuania
442 - Luxembourg
446 - Macao
450 - Madagascar
454 - Malawi
458 - Malaysia
462 - Maldives
466 - Mali
470 - Malta
474 - Martinique
478 - Mauritania
480 - Mauritius
484 - Mexico
492 - Monaco
496 - Mongolia
498 - Republic of Moldova
499 - Montenegro
500 - Montserrat
504 - Morocco
508 - Mozambique
512 - Oman
516 - Namibia
520 - Nauru
524 - Nepal
528 - Netherlands
532 - Netherlands Antilles
533 - Aruba
540 - New Caledonia
548 - Vanuatu
554 - New Zealand
558 - Nicaragua
562 - Niger
566 - Nigeria
570 - Niue
574 - Norfolk Island
578 - Norway
580 - Northern Mariana Islands
583 - Micronesia
584 - Marshall Islands
585 - Palau
586 - Pakistan
591 - Panama
598 - Papua New Guinea
600 - Paraguay
604 - Peru
608 - Philippines
612 - Pitcairn
616 - Poland
620 - Portugal
624 - Guinea-Bissau
626 - Timor-Leste
630 - Puerto Rico
634 - Qatar
638 - Réunion
642 - Romania
643 - Russia
646 - Rwanda
652 - Saint-Barthélemy
654 - Saint Helena
659 - Saint Kitts & Nevis
660 - Anguilla
662 - Saint Lucia
663 - Saint-Martin
666 - Saint Pierre & Miquelon
670 - Saint Vincent & the Grenadines
674 - San Marino
678 - Sao Tome & Principe
682 - Saudi Arabia
686 - Senegal
688 - Serbia
690 - Seychelles
694 - Sierra Leone
699 - India
702 - Singapore
703 - Slovakia
704 - Vietnam
705 - Slovenia
706 - Somalia
710 - South Africa
716 - Zimbabwe
724 - Spain
728 - South Sudan
729 - Republic of the Sudan
732 - Western Sahara
740 - Suriname
744 - Svalbard & Jan Mayen Islands
748 - Eswatini
752 - Sweden
756 - Switzerland
760 - Syria
762 - Tajikistan
764 - Thailand
768 - Togo
772 - Tokelau
776 - Tonga
780 - Trinidad & Tobago
784 - United Arab Emirates
788 - Tunisia
792 - Turkiye
795 - Turkmenistan
796 - Turks & Caicos Islands
798 - Tuvalu
800 - Uganda
804 - Ukraine
807 - Macedonia
818 - Egypt
826 - United Kingdom
834 - Tanzania
840 - United States of America
850 - US Virgin Islands
854 - Burkina Faso
858 - Uruguay
860 - Uzbekistan
862 - Venezuela
876 - Wallis & Futuna Islands
882 - Samoa
887 - Yemen
894 - Zambia
999 - Republic of Kosovo

# components.schemas.InterventionRequestDataFiltersV2.properties.intervention_types.items.description
* `2` - State loan
* `3` - Financial grant
* `4` - In-kind grant
* `5` - Production subsidy
* `6` - Interest payment subsidy
* `7` - Loan guarantee
* `8` - Tax or social insurance relief
* `9` - Competitive devaluation
* `10` - Repatriation & surrender requirements
* `11` - Controls on commercial transactions and investment instruments
* `12` - Controls on credit operations
* `13` - Control on personal transactions
* `14` - Consumption subsidy
* `15` - Tax-based export incentive
* `16` - Export subsidy
* `17` - Other export incentive
* `18` - Export tax
* `19` - Export ban
* `20` - Export tariff quota
* `21` - Export quota
* `22` - Import ban
* `23` - Import incentive
* `24` - Intellectual property protection
* `25` - FDI: Entry and ownership rule
* `26` - FDI: Treatment and operations, nes
* `27` - FDI: Financial incentive
* `28` - Local content requirement
* `29` - Local operations requirement
* `30` - Local labour requirement
* `31` - Labour market access
* `32` - Post-migration treatment
* `33` - Trade payment measure
* `34` - Trade balancing measure
* `35` - Export licensing requirement
* `36` - Import licensing requirement
* `37` - Export-related non-tariff measure, nes
* `38` - Import-related non-tariff measure, nes
* `39` - Foreign customer limit
* `40` - Public procurement preference margin
* `41` - Public procurement localisation
* `42` - Public procurement access
* `43` - Public procurement, nes
* `44` - Import tariff quota
* `45` - Import quota
* `46` - Sanitary and phytosanitary measure
* `47` - Import tariff
* `48` - Internal taxation of imports
* `49` - Technical barrier to trade
* `50` - Import monitoring
* `51` - Anti-dumping
* `52` - Safeguard
* `53` - Anti-subsidy
* `54` - Trade finance
* `55` - Financial assistance in foreign market
* `56` - Anti-circumvention
* `57` - Local content incentive
* `58` - Special safeguard
* `59` - State aid, nes
* `60` - Instrument unclear
* `61` - Price stabilisation
* `62` - State aid, unspecified
* `63` - Local supply requirement for exports
* `64` - Local value added requirement
* `65` - Local value added incentive
* `66` - Local operations incentive
* `67` - Local labour incentive
* `68` - Localisation, nes
* `69` - Voluntary export-restraint arrangements
* `70` - Voluntary export-price restraints
* `71` - Minimum import price (absolute floor)
* `72` - Minimum import price (tariff-based)
* `73` - Other import charges
* `74` - Export price benchmark
* `75` - Port restriction
* `76` - Selective import channel restriction
* `77` - Distribution restriction
* `78` - Post-sales service restriction (MAST Chapter K1)
* `79` - Corporate control order
* `80` - Debt purchase
* `81` - Equity stake
* `82` - Financial investment support
* `83` - Lending support

# components.schemas.InterventionRequestDataFiltersV2.properties.intervention_types.description
Filters by a list of intervention types directly, multiple possible.
2 - State loan
3 - Financial grant
4 - In-kind grant
5 - Production subsidy
6 - Interest payment subsidy
7 - Loan guarantee
8 - Tax or social insurance relief
9 - Competitive devaluation
10 - Repatriation & surrender requirements
11 - Controls on commercial transactions and investment instruments
12 - Controls on credit operations
13 - Control on personal transactions
14 - Consumption subsidy
15 - Tax-based export incentive
16 - Export subsidy
17 - Other export incentive
18 - Export tax
19 - Export ban
20 - Export tariff quota
21 - Export quota
22 - Import ban
23 - Import incentive
24 - Intellectual property protection
25 - FDI: Entry and ownership rule
26 - FDI: Treatment and operations, nes
27 - FDI: Financial incentive
28 - Local content requirement
29 - Local operations requirement
30 - Local labour requirement
31 - Labour market access
32 - Post-migration treatment
33 - Trade payment measure
34 - Trade balancing measure
35 - Export licensing requirement
36 - Import licensing requirement
37 - Export-related non-tariff measure, nes
38 - Import-related non-tariff measure, nes
39 - Foreign customer limit
40 - Public procurement preference margin
41 - Public procurement localisation
42 - Public procurement access
43 - Public procurement, nes
44 - Import tariff quota
45 - Import quota
46 - Sanitary and phytosanitary measure
47 - Import tariff
48 - Internal taxation of imports
49 - Technical barrier to trade
50 - Import monitoring
51 - Anti-dumping
52 - Safeguard
53 - Anti-subsidy
54 - Trade finance
55 - Financial assistance in foreign market
56 - Anti-circumvention
57 - Local content incentive
58 - Special safeguard
59 - State aid, nes
60 - Instrument unclear
61 - Price stabilisation
62 - State aid, unspecified
63 - Local supply requirement for exports
64 - Local value added requirement
65 - Local value added incentive
66 - Local operations incentive
67 - Local labour incentive
68 - Localisation, nes
69 - Voluntary export-restraint arrangements
70 - Voluntary export-price restraints
71 - Minimum import price (absolute floor)
72 - Minimum import price (tariff-based)
73 - Other import charges
74 - Export price benchmark
75 - Port restriction
76 - Selective import channel restriction
77 - Distribution restriction
78 - Post-sales service restriction (MAST Chapter K1)
79 - Corporate control order
80 - Debt purchase
81 - Equity stake
82 - Financial investment support
83 - Lending support

# components.schemas.InterventionRequestDataFiltersV2.properties.mast_chapters.items.description
* `1` - A: Sanitary and phytosanitary measure
* `2` - B: Technical barriers to trade
* `3` - Capital control measures
* `4` - D: Contingent trade-protective measures
* `5` - E: Non-automatic licensing, quotas etc.
* `6` - F: Price-control measures, including additional taxes and charges
* `7` - FDI measures
* `8` - G: Finance measures
* `9` - I: Trade-related investment measures
* `10` - L: Subsidies (excl. export subsidies)
* `11` - M: Government procurement restrictions
* `12` - Migration measures
* `13` - N: Intellectual Property
* `14` - P: Export-related measures (incl. subsidies)
* `15` - Tariff measures
* `16` - Instrument unclear
* `17` - C: Pre-shipment inspection and other formalities
* `18` - H: Measures affecting competition
* `19` - J: Distribution restrictions
* `20` - K: Restrictions on post-sales services

# components.schemas.InterventionRequestDataFiltersV2.properties.mast_chapters.description
Filters by a list of MAST chapters, multiple possible.
1 - A: Sanitary and phytosanitary measure
2 - B: Technical barriers to trade
3 - Capital control measures
4 - D: Contingent trade-protective measures
5 - E: Non-automatic licensing, quotas etc.
6 - F: Price-control measures, including additional taxes and charges
7 - FDI measures
8 - G: Finance measures
9 - I: Trade-related investment measures
10 - L: Subsidies (excl. export subsidies)
11 - M: Government procurement restrictions
12 - Migration measures
13 - N: Intellectual Property
14 - P: Export-related measures (incl. subsidies)
15 - Tariff measures
16 - Instrument unclear
17 - C: Pre-shipment inspection and other formalities
18 - H: Measures affecting competition
19 - J: Distribution restrictions
20 - K: Restrictions on post-sales services

# components.schemas.InterventionRequestDataFiltersV2.properties.implementation_level.description
Filters by a list of implementation levels, multiple possible.
1 - Supranational
2 - National
3 - Subnational
4 - SEZ
5 - IFI
6 - NFI

# components.schemas.InterventionRequestDataFiltersV2.properties.eligible_firms.items.description
* `1` - all
* `2` - SMEs
* `3` - firm-specific
* `4` - state-controlled
* `5` - state trading enterprise
* `6` - sector-specific
* `7` - location-specific
* `8` - processing trade

# components.schemas.InterventionRequestDataFiltersV2.properties.eligible_firms.description
Filters by a list of eligible firm types, multiple possible.
1 - all
2 - SMEs
3 - firm-specific
4 - state-controlled
5 - state trading enterprise
6 - sector-specific
7 - location-specific
8 - processing trade

# components.schemas.InterventionTickerPublicSerializerV2.description
Serializer for /ticker endpoint output - description-centric format.
Primary focus: InterventionDescription with nested intervention data.

# components.schemas.InterventionTickerPublicSerializerV2.properties.id.description
Unique identifier of the intervention description update.

# components.schemas.InterventionTickerPublicSerializerV2.properties.intervention_id.description
Unique identifier of the GTA intervention this ticker update belongs to.

# components.schemas.InterventionTickerPublicSerializerV2.properties.update_id.description
Sequential update number within the intervention description history.

# components.schemas.InterventionTickerPublicSerializerV2.properties.status.description
Lifecycle status of this ticker update. Possible values include `new`, `changed`, and `static`.

# components.schemas.InterventionTickerPublicSerializerV2.properties.modified.description
ISO 8601 timestamp when this ticker update was last modified.

# components.schemas.InterventionTickerPublicSerializerV2.properties.description.description
Updated intervention description text in the requested text format.

# components.schemas.InterventionTickerPublicSerializerV2.properties.intervention.description
Nested GTA intervention snapshot associated with this ticker update.

# components.schemas.InterventionTickerRequestBody.description
Reusable serializer for intervention API request body

# components.schemas.InterventionTickerRequestBody.properties.limit.description
Set the size of the result set here. Accepted is any number between 0 and 1000.

# components.schemas.InterventionTickerRequestBody.properties.offset.description
Use this parameter to paginate through the output, it accepts any number.

# components.schemas.InterventionTickerRequestBody.properties.sorting.description
Define the parameters you would like to sort the output by, accepted are `datetime_modified`, `intervention_id`, `date_announced`. Combine multiple order clauses together in the same string by separating them via a comma, e.g. `datetime_modified`. Reverse the order by adding a `-` in front of the order clause you want to reverse, e.g. `-datetime_modified`.

# components.schemas.InterventionTickerRequestBody.properties.show_keys.description
List of keys to include in the output. If not provided, all keys will be shown. Flat entries keep a top-level key (e.g. `status`, `modified`); dotted entries project the nested intervention object (e.g. `intervention.gta_evaluation`, `intervention.intervention_url`). 

# components.schemas.InterventionTickerRequestBody.properties.text_format.description
Specify the format for text fields (description, source, stated_motive). Accepts "html" (default) or "markdown".

* `html` - html
* `markdown` - markdown

# components.schemas.InterventionTickerRequestBody.properties.request_data.description
This parameter accepts an object containing the key-value pairs used as filters.

# components.schemas.NegativeListS301.description
Negative-list Section 301 parameters + per-line carve-out membership.

Present only for countries with a negative-list archetype (e.g. Brazil); null
otherwise. All values are engine-resolved, not hardcoded — a client derives
the partial rates from the shares, e.g. the aircraft rate as
`blanket_rate * (1 - civil_aircraft_share)` and the pharma-applications rate
as `blanket_rate * nonpharma_use_share`.

# components.schemas.NegativeListS301.properties.un_code.description
UN M49 country code the negative-list archetype applies to.

# components.schemas.NegativeListS301.properties.blanket_rate_type.description
Engine rate_type for the blanket (e.g. 'bra_s301_rate').

# components.schemas.NegativeListS301.properties.blanket_rate.description
Engine-resolved blanket rate in percentage points: 0 before the effective date (2026-07-22 for Brazil), the configured blanket when in force or when the action is activated for the request.

# components.schemas.NegativeListS301.properties.civil_aircraft_share_type.description
Engine share_type for the civil-aircraft share (e.g. 'bra_civil_aircraft_share').

# components.schemas.NegativeListS301.properties.civil_aircraft_share.description
Civil-aircraft share (0-1). Reported even when the blanket is inactive so the aircraft rate `blanket_rate * (1 - civil_aircraft_share)` is derivable. Null if the share is not configured.

# components.schemas.NegativeListS301.properties.nonpharma_use_share_type.description
Engine share_type for the non-pharma-use share (e.g. 'bra_nonpharma_use_share').

# components.schemas.NegativeListS301.properties.nonpharma_use_share.description
Non-pharma-use share (0-1, uncalibrated placeholder 0.5) weighting the pharmaceutical-applications partial: `blanket_rate * nonpharma_use_share`. Null if the share is not configured.

# components.schemas.NegativeListS301.properties.steel_derivative_share.description
Steel metal-content incidence share weighting the out-of-chapter de-minimis split: `blanket_rate * (1 - steel_derivative_share)`. Null if not configured.

# components.schemas.NegativeListS301.properties.alu_derivative_share.description
Aluminium metal-content incidence share weighting the out-of-chapter de-minimis split: `blanket_rate * (1 - alu_derivative_share)`. Null if not configured.

# components.schemas.NegativeListS301.properties.copper_main_share.description
Copper-main metal-content incidence share weighting the out-of-chapter de-minimis split: `blanket_rate * (1 - copper_main_share)`. Null if not configured.

# components.schemas.NegativeListS301.properties.semicon_technical_share.description
Share of the semiconductor scope meeting the U.S. note 39(b) technical-parameter bands (uncalibrated placeholder 0.05), weighting the semiconductor carve-out: `blanket_rate * (1 - semicon_technical_share)`. Null if not configured.

# components.schemas.NegativeListS301.properties.carve_out_membership.description
This line's effective carve-out (annex / annex_ex / statutory / chapter_98 / s232_closed_list / annex_aircraft / annex_pharma / s232_metal_split_steel / s232_metal_split_alu / s232_metal_split_copper / semiconductor / plain), in engine precedence order.

# components.schemas.NegativeListS301.properties.carve_out_precedence.description
The carve-out precedence sequence the engine applies.

# components.schemas.NegativeListS301.properties.archetype.description
The negative-list archetype spec, including the verbal precedence description.

# components.schemas.PaginatedDealToggleListList.properties.next.description
URL for the next page of results, or null when there is no next page.

# components.schemas.PaginatedDealToggleListList.properties.previous.description
URL for the previous page of results, or null when there is no previous page.

# components.schemas.PaginatedImpactChainProductListList.properties.next.description
URL for the next page of results, or null when there is no next page.

# components.schemas.PaginatedImpactChainProductListList.properties.previous.description
URL for the previous page of results, or null when there is no previous page.

# components.schemas.PaginatedImpactChainSectorListList.properties.next.description
URL for the next page of results, or null when there is no next page.

# components.schemas.PaginatedImpactChainSectorListList.properties.previous.description
URL for the previous page of results, or null when there is no previous page.

# components.schemas.PaginatedInterventionFullListPublicSerializerV2List.properties.next.description
URL for the next page of results, or null when there is no next page.

# components.schemas.PaginatedInterventionFullListPublicSerializerV2List.properties.previous.description
URL for the previous page of results, or null when there is no previous page.

# components.schemas.PaginatedInterventionTickerPublicSerializerV2List.properties.next.description
URL for the next page of results, or null when there is no next page.

# components.schemas.PaginatedInterventionTickerPublicSerializerV2List.properties.previous.description
URL for the previous page of results, or null when there is no previous page.

# components.schemas.PaginatedScenarioList.properties.next.description
URL for the next page of results, or null when there is no next page.

# components.schemas.PaginatedScenarioList.properties.previous.description
URL for the previous page of results, or null when there is no previous page.

# components.schemas.PaginatedStateActFullListPublicSerializerV1List.properties.next.description
URL for the next page of results, or null when there is no next page.

# components.schemas.PaginatedStateActFullListPublicSerializerV1List.properties.previous.description
URL for the previous page of results, or null when there is no previous page.

# components.schemas.PatchedScenarioCreate.properties.name.description
Human-readable scenario name. Must not be blank.

# components.schemas.Product.properties.description.description
HTSUS schedule description for the code.

# components.schemas.Product.properties.has_us_import_flows.description
Whether the code carries at least one row in the US import table. False means the line exists in the schedule but recorded no US imports in the reference year — it is still a valid product to price, it just contributes nothing to trade-weighted aggregates.

# components.schemas.ProductListResponse.description
Paginated product search response (DRF LimitOffset shape).

# components.schemas.ProductListResponse.properties.count.description
Total number of matching HS product records.

# components.schemas.ProductListResponse.properties.next.description
URL for the next page of product results, or null when there is no next page.

# components.schemas.ProductListResponse.properties.previous.description
URL for the previous page of product results, or null when there is no previous page.

# components.schemas.ProductListResponse.properties.results.description
Current page of HS product reference records.

# components.schemas.Proposal.description
One statelessly-activatable proposed / parked Section 301 action.

# components.schemas.Proposal.properties.name.description
Identifier to pass in `activate_proposals` (e.g. 'bra_s301').

# components.schemas.Proposal.properties.title.description
Short human-readable label for the proposal.

# components.schemas.Proposal.properties.archetype.description
Section 301 structure: 'negative_list' or 'forced_labour'.

# components.schemas.Proposal.properties.description.description
Plain-English description of the proposal and its carve-outs.

# components.schemas.Proposal.properties.rate_types.description
Engine rate_type(s) the activation un-parks.

# components.schemas.ProposalListResponse.description
Discovery response: the proposals a client may activate per request.

# components.schemas.ProposalListResponse.properties.proposals.description
Proposed/parked actions activatable via `activate_proposals=` on the calculate and aggregate endpoints.

# components.schemas.Scenario.properties.id.description
Unique scenario identifier. The baseline scenario is conventionally `1`.

# components.schemas.Scenario.properties.is_baseline.description
Whether this is the read-only baseline scenario.

# components.schemas.Scenario.properties.user.description
ID of the user who owns this custom scenario; null or omitted for shared baseline scenarios.

# components.schemas.Scenario.properties.created_at.description
ISO 8601 timestamp when the scenario was created.

# components.schemas.ScenarioCreate.properties.name.description
Human-readable scenario name. Must not be blank.

# components.schemas.SemanticSearchRequest.description
Validates the request body for the GTA semantic-search public API endpoint.

# components.schemas.SemanticSearchRequest.properties.query.description
Natural-language query forwarded to the RAG backend.

# components.schemas.SemanticSearchRequest.properties.intervention_ids.description
Optional list of intervention IDs to scope the semantic search to.

# components.schemas.SemanticSearchRequest.properties.limit.description
Maximum number of results to return. Capped at 100.

# components.schemas.SemanticSearchRequest.properties.show_keys.description
Optional list of field names to project per result. Use ["*"] for the full record. Unknown names silently dropped by the RAG backend.

# components.schemas.SemanticSearchRequest.properties.include_matched_snippets.description
When True, each result carries 1–2 sentences from the intervention's description that matched the query.

# components.schemas.StateActFullListPublicSerializerV1.description
Full-access serializer for Public API V1 `/gta/state-act/` endpoint.
Adds state_act_source and is_official_source; nested interventions use the full variant.

# components.schemas.StateActFullListPublicSerializerV1.properties.state_act_id.description
Unique identifier of the parent state act.

# components.schemas.StateActFullListPublicSerializerV1.properties.state_act_url.description
Public GTA URL for the parent state act.

# components.schemas.StateActFullListPublicSerializerV1.properties.state_act_source.description
Source entries associated with the state act.

# components.schemas.StateActFullListPublicSerializerV1.properties.is_official_source.description
Whether the state act source is official.

# components.schemas.StateActFullListPublicSerializerV1.properties.gta_evaluation.description
GTA evaluation category assigned to the intervention or state act.

# components.schemas.StateActFullListPublicSerializerV1.properties.date_published.description
Date the policy was published in the database.

# components.schemas.StateActFullListPublicSerializerV1.properties.interventions.description
Interventions associated with this resource.

# components.schemas.StateActRequestBodyV1.description
Reusable serializer for state act API request body

# components.schemas.StateActRequestBodyV1.properties.limit.description
Set the size of the result set here. Accepted is any number between 0 and 1000.

# components.schemas.StateActRequestBodyV1.properties.offset.description
Use this parameter to paginate through the output, it accepts any number.

# components.schemas.StateActRequestBodyV1.properties.sorting.description
Define the parameters you would like to sort the output by, accepted are `state_act_id`, `state_act_title`, `gta_evaluation`, `intervention_id`, `date_announced`, `date_published`, `date_implemented`, `date_removed`, `last_updated`, `eligible_firm`, `implementation_level`, `intervention_type`, `mast_chapter`, `mast_subchapter`, `affected_sectors`, `affected_products`, and `sources`. Combine multiple order clauses by separating them with a comma, e.g. `date_announced,state_act_id`. Prefix with `-` to reverse a clause, e.g. `-date_announced`.

# components.schemas.StateActRequestBodyV1.properties.show_full_names.description
Boolean filter defining if product and sector names should be outputted in full. Per default these values are truncated to 20 characters, in order to reduce the result size.

# components.schemas.StateActRequestBodyV1.properties.show_keys.description
List of top-level keys to include in the output. If not provided, all keys will be shown.

# components.schemas.StateActRequestBodyV1.properties.request_data.description
This parameter accepts an object containing the key-value pairs used as filters. A state act is returned when any of its interventions match the filters.

# components.schemas.StateActSource.properties.status.description
Lifecycle status of this source entry. Values are returned in lowercase, for example `new`, `changed`, or `static`.

# components.schemas.StateActSource.properties.order_nr.description
Display order of this source entry within the state act source list.

# components.schemas.StateActSource.properties.modified.description
Timestamp when this source entry was last modified, formatted as `YYYY-MM-DD HH:MM`, or null when unavailable.

# components.schemas.StateActSource.properties.text.description
Source text in the requested text format.

# components.schemas.TariffResult.properties.hs_8digit.description
Eight-digit HS product code used for the calculation.

# components.schemas.TariffResult.properties.un_code.description
UN M49 country code used by the tariff engine.

# components.schemas.TariffResult.properties.country_name.description
Human-readable country name for `un_code`.

# components.schemas.TariffResult.properties.hts_rate.description
Base HTS tariff component in percentage points.

# components.schemas.TariffResult.properties.s232_rate.description
Section 232 tariff component in percentage points.

# components.schemas.TariffResult.properties.ieepa_rate.description
IEEPA tariff component in percentage points.

# components.schemas.TariffResult.properties.s122_rate.description
Section 122 tariff component in percentage points.

# components.schemas.TariffResult.properties.emergency_rate.description
Emergency tariff component in percentage points.

# components.schemas.TariffResult.properties.s301_rate.description
Section 301 tariff component in percentage points.

# components.schemas.TariffResult.properties.s338_rate.description
Section 338 tariff component in percentage points (Canada three actions, additive and unweighted; nonzero only for Canada-origin basket members from 2026-08-22 — the proclaimed 2026-08-19 start was suspended by Proclamation 11056, so the component is 0 on 2026-08-19 to 2026-08-21).

# components.schemas.TariffResult.properties.final_rate.description
Final applied tariff rate in percentage points after combining all applicable components.

# components.schemas.TariffResult.properties.rate_formula.description
Formula branch used by the engine to combine tariff components.

# components.schemas.TariffResult.properties.uas_coverage_share.description
S232 UAS only (null on every other formula): the fraction of this line's value the UAS proclamation actually reaches, after any clause-7 firm deferral. 1.0 on the whole-code 8806 baskets; a small end-use share on the 8807 parts baskets and static converters 8504.40.95, where chapter 99 heading 9903.08.20 leaves articles not for use in UAS on their existing footing. `s232_rate` is the statutory rate on that covered slice, so the line's effective S232 burden is the product of the two — the uncovered remainder keeps paying IEEPA/S122.

# components.schemas.TariffResult.properties.trade_value_usd.description
Trade value for this product-country flow in US dollars.

# components.schemas.TimelineEvent.properties.date.description
Policy event date in ISO 8601 date format.

# components.schemas.TimelineEvent.properties.type.description
Policy event category, such as a regime activation or bilateral deal.

# components.schemas.TunableParameter.properties.value.description
Current value of the parameter under the requested scenario.

# components.schemas.TunableParameter.properties.type.description
Whether the parameter takes a numeric range or an enumerated option.

* `continuous` - continuous
* `discrete` - discrete

Possible values: `continuous` - Numeric parameter that can vary over a range.; `discrete` - Parameter with a fixed set of allowed options..

# components.schemas.TunableParameter.properties.type.x-enumDescriptions[]
Numeric parameter that can vary over a range.

# components.schemas.TunableParameter.properties.type.x-enumDescriptions[]
Parameter with a fixed set of allowed options.

# components.schemas.TunableParameter.properties.step.description
Suggested UI step size for continuous parameters.

# components.schemas.TunableParameter.properties.description.description
Plain-English description of what the parameter does.

# components.schemas.TunableParameter.properties.sensitivity.description
Model author's assessment of how much this parameter moves the final rate.

* `high` - high
* `medium` - medium
* `low` - low

Possible values: `high` - High sensitivity; changes can materially affect the result.; `medium` - Medium sensitivity; changes can moderately affect the result.; `low` - Low sensitivity; changes usually have limited effect..

# components.schemas.TunableParameter.properties.sensitivity.x-enumDescriptions[]
High sensitivity; changes can materially affect the result.

# components.schemas.TunableParameter.properties.sensitivity.x-enumDescriptions[]
Medium sensitivity; changes can moderately affect the result.

# components.schemas.TunableParameter.properties.sensitivity.x-enumDescriptions[]
Low sensitivity; changes usually have limited effect.

# components.securitySchemes.APIKey.description
API Key authentication. Use the format: APIKey [YOUR_API_KEY].

# components.securitySchemes.MCPBearer.description
MCP OAuth2 bearer token authentication. Use the format: Bearer [ACCESS_TOKEN].

# tags[].description
GTA Data V2 endpoints allow to extract lists of policies from the GTA database filtered by different criteria.

# tags[].description
GTA Data Counts endpoints allow to retrieve aggregated intervention counts.

# tags[].description
GTA Ticker endpoints allow to more easily extract updates to existing policies. When we are updating a policy description, the ticker endpoint provides you with a ticker entry for that update.

# tags[].description
GTA impact chains allow to extract impact chains of implementing_jurisdiction-product_id-affected_jurisdiction tuples. The standard GTA data endpoint aggregates this kind of data into a single entry. The impact chain endpoints allow to retrieve it in a unaggregated format.

### Format explanation
In this section, more information about the output format of the impact chain endpoints is provided. For general information on the methodology of our data processing workflow, please refer to the GTA Handbook: <a href="https://globaltradealert.org/methodology" target="_blank" rel="noopener noreferrer">https://globaltradealert.org/methodology</a>.

The difference between the standard data endpoint and the impact chain endpoints is in the way both endpoints output information of affected products/sectors and jurisdictions for each intervention. Consider the following fictional example intervention, the way it would be returned via the Data endpoint:
<details>
<summary>Show/hide aggregated example response</summary>

```json
{
    "intervention_id": 123456,
    /* ... other intervention fields ... */
    "intervention_url": "https://globaltradealert.org/intervention/123456",
    "implementing_jurisdiction": {
        "jurisdiction_id": 156,
        "name": "China",
        "iso": "CHN"
    },
    "affected_jurisdictions": [
        {
            "jurisdiction_id": 276,
            "name": "Germany",
            "iso": "DEU"
        },
        {
            "jurisdiction_id": 250,
            "name": "France",
            "iso": "FRA"
        }
    ],
    "affected_products": [
        {
            "product_id": 123,
            "name": "Product A",
            "date_implemented": "2024-01-01",
            "date_removed": null
        },
        {
            "product_id": 456,
            "name": "Product B",
            "date_implemented": "2024-01-01",
            "date_removed": "2025-01-01"
        }
    ]
}
```
</details>

This output format allows to see which jurisdictions and products are affected by the intervention in general. It does not show in detail which jurisdiction is affected by what kind of product. For this reason, the impact chain endpoints exist.

Consider the same example as before as it would be outputted by the impact chains product endpoint:

<details>
<summary>Show/hide impact chains product example response</summary>

```json

[
    {
        "intervention_id": 123456,
        "intervention_url": "https://globaltradealert.org/intervention/123456",
        "implementing_jurisdiction": {
            "jurisdiction_id": 156,
            "name": "China",
            "iso": "CHN"
        },
        "affected_jurisdictions": [
            {
                "jurisdiction_id": 276,
                "name": "Germany",
                "iso": "DEU"
            },
        ],
        "affected_products": [
            {
                "product_id": 123,
                "name": "Product A"
            },
        ],
        "date_implemented": "2024-01-01",
        "date_removed": null,
        "prior_level": "0",
        "new_level": "25",
        "unit": "percent"
    },
    {
        "intervention_id": 123456,
        "intervention_url": "https://globaltradealert.org/intervention/123456",
        "implementing_jurisdiction": {
            "jurisdiction_id": 156,
            "name": "China",
            "iso": "CHN"
        },
        "affected_jurisdictions": [
            {
                "jurisdiction_id": 250,
                "name": "France",
                "iso": "FRA"
            },
        ],
        "affected_products": [
            {
                "product_id": 456,
                "name": "Product B"
            },
        ],
        "date_implemented": "2024-01-01",
        "date_removed": "2025-01-01",
        "prior_level": null,
        "new_level": null,
        "unit": null
    }
]
```
</details>

Note how instead of 1 single entry, the intervention is now outputted split up into multiple entries, each containing one impact chain. This example is showing chains based on HS product codes. The impact chains sector endpoint can be used to retrieve the same kind of information for CPC sector codes instead.

# tags[].description
GTA Mapping Helpers endpoints can be used to retrieve filter options and mapping data.

# tags[].description
GTA Semantic Search returns the matching interventions ranked by semantic similarity. Use it when keyword or structured filters are not enough — e.g. to surface interventions described in conceptually related language rather than by exact terms.

# tags[].description
TAU calculate endpoints compute the **applied** US tariff rate (not statutory MFN) for any product-country-date combination, as implied by the full set of tariff measures in force on that date.

**Methodology:** the SGEPT US Tariff Barrier Estimates. Each rate decomposes into seven instruments — HTS / Section 232 / IEEPA / Section 122 / emergency / Section 301 / Section 338 — combined by one of seven mutually-exclusive formulas (no new tariffs, transport S232, materials S232, IEEPA/S122 additive, pharma S232, polysilicon S232, UAS S232). Section 338 (`s338_rate`) is a separate additive, unweighted column for the three Canada actions in force 2026-08-19; it is 0 outside Canada-origin basket members on/after that date. Coverage: ~234,846 product-country flows, $3,240bn of 2024 US imports.

**Time range:** any policy date from 2025-01-20 onwards. The engine reconstructs the full regime stack as of the requested date, so pre-SCOTUS dates return IEEPA-based rates and post-SCOTUS dates (2026-02-20 onwards) return S122-based rates.

**Three endpoints:**
- `/calculate/single/` — the applied rate and its components. Use when you just want the number.
- `/calculate/single/kit/` — the rate PLUS a self-contained **calculation kit** (formula expression, tunable parameters with sensitivity hints, deals in force with counterfactual rates, artifact suggestion). Use when you want an LLM or frontend to explain the rate or offer interactive sensitivity controls. This is the endpoint the sgept-gta-mcp tariff tools consume.
- `/calculate/batch/` — bulk rates for many flows in one call.

**Gotchas to be aware of:**
- Metal content ratios (e.g. `steel_derivative_share = 0.40`) are empirical incidence ratios calibrated from customs revenue, NOT physical metal content percentages.
- The Japan, EU and Korea S232 floor deals all apply to auto and auto parts only. MHDV (heavy trucks, buses, MHDV parts) pays the standard S232 rates regardless of origin.
- Section 122 is statutorily exclusive of Section 232 products (they do not stack).
- The S232 UAS layer (from 2026-09-03) is the one Section 232 action that does NOT displace IEEPA/S122 outright. On the 8807 aircraft-parts baskets and static converters 8504.40.95 it reaches only the UAS-use share of the line, so the rest of the line keeps paying the reciprocal layers. A UAS row's `s232_rate` is the statutory rate on the covered slice, not the line's effective S232 burden — read `rate_formula` to tell the whole-code variant from the end-use-limited one.
- Control panels 8537.10.91 sit in two S232 actions at once (auto parts since 2025-05-03, UAS docking stations from 2026-09-03). The line stays auto-parts-owned and carries a share-weighted blend of both rates, so its `s232_type` reads `auto_parts` even though part of its value is priced by the UAS proclamation.
- GTA's UN M49 codes diverge from some standard values (India = 699 in GTA, not 356). Always resolve via `/reference/countries/`.

# tags[].description
TAU scenario endpoints let callers create and manage custom tariff scenarios — copies of the baseline with modified rates, shares, or deal toggles — to run counterfactual analyses.

- `/scenario/` — list / create / retrieve / update / delete scenarios. The baseline (`id=1`) is read-only.
- `/deal/?scenario_id=<int>` — list which bilateral deals are enabled for a scenario.
- `/deal/toggle/?scenario_id=<int>&name=<deal_name>` — toggle a deal on or off for a scenario.

Once a scenario is configured, pass its `scenario_id` to any `/calculate/*` endpoint to get rates computed under that scenario's parameters.

# tags[].description
TAU reference endpoints expose the country, product, and policy-timeline lookups used by the tariff engine. Use these to resolve human-readable names into the UN M49 and HS8 codes the `/calculate/*` endpoints expect.

# tags[].description
TAU aggregate endpoints compute trade-weighted summaries on top of the per-flow `/calculate/*` engine — useful when you want a single number for a country, group, or date instead of a row-by-row breakdown.

- `/aggregate/timeline/` — trade-weighted applied rate sampled across a date range; one row per sampled policy date. Optional `countries=...` adds per-country overlay rates for comparative time-series.
- `/aggregate/country_ranking/` — top-N countries inside a group (`WORLD`/`G20`/`G7`/`BRICS`/`ASEAN`/`LDC`) by applied rate, or by rate delta when `compare_date` is supplied.
- `/aggregate/advantage/` — per-product comparison of one country's applied rate against either the rest-of-world peer rate or a single `compare_un_code` peer.
- `/aggregate/country_brief/` — HS2 chapter breakdown plus top-N most-exposed HS8 products for one country.

All endpoints share the standard `policy_date` / `scenario_id` parameters and respect the documented per-endpoint `top_n` / `sample_size` caps (422 on overflow).

# tags[].description
Account-level API usage overview: packages, active keys, and per-product usage limits.