---
title: International Trade Country Risk API
slug: exporter-country-facts-api
url: https://apyhub.com/193market/service/exporter-country-facts-api
provider: 193market
auth: api_key
version: 0.1.0
service_type: sync
endpoints: 4
atoms: 10
mcp: true
---

# International Trade Country Risk API

Look up, compare and rank countries by OECD country risk grade, UK Export Finance cover policy, and World Bank macro, governance and Enterprise Survey indicators — one call per country, comparison or ranking.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/193market/exporter-country-facts-api/countries/:code` | What it does Returns the key published facts about a single country using its ISO country code. It… | 10 |
| GET | `https://api.eu.apyhub.com/193market/exporter-country-facts-api/compare` | What it does Compares headline country figures for up to 10 countries in a single request. It gives… | 10 |
| GET | `https://api.eu.apyhub.com/193market/exporter-country-facts-api/indicators` | What it does Returns the complete list of indicators supported by the API. Use this endpoint to: Di… | 10 |
| GET | `https://api.eu.apyhub.com/193market/exporter-country-facts-api/rankings` | What it does Returns countries ordered according to a selected indicator. For example, you can rank… | 10 |

## Endpoint reference

### Country Risk Profile

`GET https://api.eu.apyhub.com/193market/exporter-country-facts-api/countries/:code` · 10 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `code` | path | string | yes | Code |

#### Quickstart

```bash
curl "https://api.eu.apyhub.com/193market/exporter-country-facts-api/countries/:code" \
  -H 'apy-token: $APY_TOKEN'
```

##### what you will get

```json
{
  "iso3": "VNM",
  "iso2": "VN",
  "name": "Vietnam",
  "headline": {
    "oecd_grade": 3,
    "oecd_grade_change": "improved",
    "ukef_short_term_cover": "Yes",
    "ukef_medium_long_term_cover": "Yes",
    "rule_of_law_estimate": -0.3139343,
    "inflation_pct": 3.3099931421974,
    "inflation_year": "2025"
  },
  "flags": [
    "reserves_below_3_months"
  ]
}
```

### Compare Countries 

`GET https://api.eu.apyhub.com/193market/exporter-country-facts-api/compare` · 10 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `countries` | query | string | yes | Comma-separated ISO codes, up to 10, e.g. VN,NG,AR,KR |

#### Quickstart

```bash
curl "https://api.eu.apyhub.com/193market/exporter-country-facts-api/compare?countries=VN,NG,AR,KR" \
  -H 'apy-token: $APY_TOKEN'
```
##### what you will get 

```json
{
  "countries": [
    {
      "iso3": "VNM",
      "iso2": "VN",
      "name": "Vietnam",
      "found": true,
      "headline": {
        "oecd_grade": 3,
        "oecd_grade_change": "improved",
        "ukef_short_term_cover": "Yes",
        "ukef_medium_long_term_cover": "Yes",
        "rule_of_law_estimate": -0.3139343,
        "inflation_pct": 3.3099931421974,
        "inflation_year": "2025"
      },
      "flags": [
        "reserves_below_3_months"
      ]
    }
  ]
}
```

### Indicators, sources and freshness

`GET https://api.eu.apyhub.com/193market/exporter-country-facts-api/indicators` · 10 atoms · accepts `application/json` · returns `application/json`

#### Quickstart

```bash
curl "https://api.eu.apyhub.com/193market/exporter-country-facts-api/indicators" \
  -H 'apy-token: $APY_TOKEN'
```
##### What you'll get back
 
```json
{
  "indicators": [
    {
      "id": "wdi_inflation_cpi_pct",
      "section": "macro",
      "label": "Inflation, consumer prices (annual %)",
      "unit": "%",
      "source": "wb_indicators",
      "countries": 193,
      "periods": [
        "2011",
        "2025"
      ]
    },
    {
      "id": "wdi_reserves_months_imports",
      "section": "macro",
      "label": "Total reserves in months of imports",
      "unit": "months of imports",
      "source": "wb_indicators",
      "countries": 179,
      "periods": [
        "1982",
        "2025"
      ]
    }
  ]
}
```

### Rank Countries by an Indicator

`GET https://api.eu.apyhub.com/193market/exporter-country-facts-api/rankings` · 10 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `limit` | query | integer | no | 1–250 Default: `50`. |
| `order` | query | string | no | desc (highest first) or asc Default: `desc`. |
| `indicator` | query | string | yes | Indicator id from GET /v1/indicators, e.g. wgi_rule_of_law |

#### Quickstart

```bash
curl "https://api.eu.apyhub.com/193market/exporter-country-facts-api/rankings?indicator=wdi_inflation_cpi_pct&order=desc&limit=10" \
  -H 'apy-token: $APY_TOKEN'
```

##### what you will get 

```json
{
  "indicator": "wdi_inflation_cpi_pct",
  "label": "Inflation, consumer prices (annual %)",
  "unit": "%",
  "order": "desc",
  "note": null,
  "results": [
    {
      "rank": 1,
      "iso3": "VEN",
      "iso2": "VE",
      "name": "Venezuela",
      "value": 254.948534781816,
      "period": "2016",
      "old": true
    },
    {
      "rank": 2,
      "iso3": "ARG",
      "iso2": "AR",
      "name": "Argentina",
      "value": 219.883929014578,
      "period": "2024",
      "old": false
    }
  ]
}
```

## About

## What it does

International Trade Country Risk API gives you structured country information, using the latest published figures, to help assess a market from an export and country-risk perspective. It brings together data from the OECD (Organisation for Economic Co-operation and Development), UKEF (UK Export Finance), MIGA (Multilateral Investment Guarantee Agency), and the World Bank, covering country risk, export finance, macroeconomic conditions, governance, business environment, and investment guarantees.

For a country, you can get key facts such as its OECD country risk classification, UKEF cover position, inflation, foreign-exchange reserves, governance indicators, Enterprise Survey information, and MIGA guarantee exposure. The API also provides threshold-based flags where applicable, helping you quickly identify specific conditions in the available data.

You can also compare up to 10 countries using their headline figures, or rank countries against a specific supported indicator. The available indicators include their definitions, units, sources, country coverage, and reporting periods, so you can understand exactly what a value represents before using it.

Use it for export-market research, country risk analysis, credit assessment, market comparison, trade planning, and internal dashboards where you need consistent country-level facts from multiple published sources in one place.

The API provides published figures only. It does not rate countries, provide credit advice, or recommend whether to trade with a country. Flags are not a country score, and country-level data does not describe the creditworthiness of an individual buyer. Different indicators may come from different sources and reporting periods, so each value should be interpreted together with its source and period.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/193market/service/exporter-country-facts-api
