Skip to main content
GET
/
v1
/
countries
List countries with policy intelligence
curl --request GET \
  --url https://vcm-fyi-api.fly.dev/v1/countries/ \
  --header 'X-API-KEY: <api-key>'
{
  "pagination": {
    "total_entries": 123,
    "current_page": 123,
    "total_pages": 123,
    "next_page": "<string>"
  },
  "data": [
    {
      "country_code": "<string>",
      "country_name": "<string>",
      "region": "<string>",
      "article6_status": "<string>",
      "article6_host_loas": 123,
      "corsia_eligible": true,
      "has_carbon_tax": true,
      "has_ets": true,
      "vcm_regulatory_status": "<string>",
      "market_outlook": "<string>",
      "is_buyer_country": false,
      "article6_buyer_loas": 0,
      "has_initial_report": false,
      "has_dna": false,
      "jcm_project_count": 0,
      "export_restrictions": false,
      "ca_policy": "<string>",
      "country_risk_score": 123,
      "total_projects": 0,
      "total_credits_issued": 0,
      "total_credits_retired": 0,
      "project_count": 0,
      "total_issued": 0,
      "total_retired": 0
    }
  ]
}

Authorizations

X-API-KEY
string
header
required

Query Parameters

region
string | null

Filter by region (e.g., Africa, Asia)

subregion
string | null

Filter by subregion (e.g., Southeast Asia)

article6_status
string | null

Filter by Article 6 status: active, developing, none

corsia_eligible
boolean | null

Filter by CORSIA eligibility

has_carbon_tax
boolean | null

Filter by carbon tax presence

has_ets
boolean | null

Filter by ETS presence

vcm_regulatory_status
string | null

Filter by VCM status: welcoming, regulated, restricted, banned

search
string | null

Search country name

current_page
integer
default:1

Page number

Required range: x >= 1
per_page
integer
default:50

Items per page

Required range: 1 <= x <= 100
sort
string
default:-project_count

Sort field: country_name, project_count, article6_host_loas. Prefix with - for desc

Response

Paginated list of countries with policy and project statistics

Paginated response for country policy list.

pagination
Pagination · object
required
data
CountryPolicySummary · object
required

Summary model for country list view.