---
title: "Trade-policy interventions list"
method: GET
path: "/api/v1/gta/interventions"
tags: ["Global Economy & Trade"]
---

# Trade-policy interventions list

`GET /api/v1/gta/interventions`

Structured record of government trade-policy interventions since 2008 - tariffs, quotas, subsidies, sanctions, export controls, FDI screening. 30,000+ measures curated by the GTA Analytics team. Filter by implementing or affected jurisdiction (ISO-3 alpha, Sugra translates to GTA numeric), MAST chapter (A-P), intervention-type ID (see /mappings), and announcement date window. Upstream enforces a 1000-row hard cap per page; requests beyond 1000 are walked across multiple pages transparently. Data (c) Global Trade Alert (St. Gallen Endowment). Licensed CC BY 4.0.

## Query parameters

- `jurisdiction_implementing` string, nullable — Implementing jurisdiction as ISO-3 alpha (e.g. USA, CHN) or GTA numeric.
- `jurisdiction_affected` string, nullable — Affected jurisdiction as ISO-3 alpha (e.g. CHN) or GTA numeric.
- `mast_chapter` string, nullable — MAST chapter letter (A-P) or numeric ID. See /mappings for the full list.
- `intervention_type` string, nullable — Intervention-type ID or label (e.g. `47` for Import tariff). See /mappings.
- `start_date` string, nullable — Announcement window start (YYYY-MM-DD).
- `end_date` string, nullable — Announcement window end (YYYY-MM-DD).
- `page` integer — 1-based page number.
- `limit` integer — Max records to return. Upstream cap is 1000 per page; larger values are walked across pages.

## Response `200`

Intervention records with announcement/implementation/removal dates, affected products (shape varies by API access tier - see `products_shape`), affected sectors, traffic-light evaluation. CC BY 4.0 attribution included.

- EnvelopeGtaInterventionsPayload
  - `data` GtaInterventionsPayload, required — Paged list of trade-policy interventions.
    - `attribution` string, required — Data licence attribution string (CC BY 4.0, Global Trade Alert).
    - `items` GtaIntervention[], required — Intervention records.
      - `id` integer, nullable — GTA intervention_id (primary key).
      - `title` string, nullable — Short title summarising the measure.
      - `intervention_type` union — Specific instrument type label or numeric ID (74 possible values).
        - string
        - integer
      - `mast_chapter` union — MAST (UNCTAD NTM) chapter letter or numeric ID (17 chapters).
        - string
        - integer
      - `color` string, nullable — GTA evaluation label - red (near-certain harm), amber (likely harm), green (liberalising).
      - `jurisdiction_implementing` unknown
      - `jurisdictions_affected` unknown[], nullable — Countries whose commercial interests are affected. GTA-numeric or name list.
        - unknown
      - `date_announced` string, nullable — Announcement date (YYYY-MM-DD, source date-only).
      - `date_implemented` string, nullable — Implementation / legal-effective date (YYYY-MM-DD).
      - `date_removed` string, nullable — Revocation date or null if the measure is still in force.
      - `affected_products` unknown[], nullable — HS 6-digit product codes touched by the measure. Basic-access tokens return a flat int list; full-access tokens return object dicts with prior/new tariff levels.
        - unknown
      - `affected_sectors` unknown[], nullable — CPC sector codes touched by the measure (int list).
        - unknown
      - `inferred` boolean, nullable — True when `jurisdictions_affected` was inferred by GTA analysts rather than stated by the implementer.
      - `source_url` string, nullable — Link to the original government act or GTA fact-sheet when available.
    - `count` integer, required — Number of records returned on this page.
    - `page` integer, required — 1-based page number requested.
    - `limit` integer, required — Records per page requested (upstream hard-cap 1000).
    - `products_shape` string, required — Shape of `affected_products` in this response: `int_list` (basic-access key) or `object_list` (full-access key with tariff prior/new levels).
  - `meta` SugraMeta, required — Metadata attached to every /api/v1/* response envelope.
    - `endpoint` string, required — Requested endpoint path.
    - `data_time` string, required — ISO 8601 UTC timestamp of the source data, not of the request.
    - `response_time` string, required — ISO 8601 UTC timestamp when this response was produced.
    - `provider` string, required — API name and version.
    - `source` string, nullable — Identifier of the primary upstream source used for this response.
    - `attribution` string, nullable — Human-readable attribution mandated by an upstream source (e.g. a securities regulator or self-regulatory organization). Present only on responses whose source requires the owner and source to be clearly identified. Do not remove or alter it when using the response.
    - `fallback_used` boolean, nullable — True when the primary source failed and a fallback produced the data.
    - `fallback_chain` string[], nullable — Ordered list of sources attempted, in the order they were tried.
    - `cached` boolean, nullable — True when this response was served from the internal cache.
    - `stale` boolean, nullable — True when the cached response was returned after the upstream rate-limited or errored. Clients can use this to detect degraded data.

## Other responses

- `401` — Missing or invalid `x-api-key` header. JSON body with a stable `code` distinguishing `missing_api_key` (no header sent) from `invalid_api_key` (header sent, key not accepted); any other 401 source carries the generic `unauthorized` with its detail as `reason`. Plus `hint`. `plan` is always null on 401 - an unauthenticated request has no plan; quota exhaustion is 429, not 401.
- `422` — Validation Error
- `429` — Daily rate limit exceeded. Check `X-RateLimit-Reset` for the next window.
- `503` — Upstream source is temporarily unavailable. Retry after a short delay.

---

[API](https://skmtc.net/sugra/apis/sugra-api.md) · [All operations](https://skmtc.net/sugra/apis/sugra-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sugra/sugra-api/versions/4c4530760ba1/schema)