GINC API

GINC uses a simplified API to provide simple and reliable access to framework data. All data is available as static files in both JSON and CSV formats at the endpoints listed below, released under a Creative Commons Attribution 4.0 International licence. Detailed field descriptions and data structure documentation are provided for each endpoint to support integration and analysis.

Endpoints

Nations

GINC API uses a standardised entity data structure to ensure consistent identification and classification of nations and territories across all capability assessments. Each record includes unique identifiers, standard ISO codes, and a classification system that distinguishes between Small Island Developing States (SIDS), microstates, standard sovereign nations, and dependent territories. This structure enables precise cross-referencing with international datasets whilst accounting for the distinct analytical requirements of entities at different scales.

Figure 1. GINC Nations Data Model

Nations API Call

fetch('https://api.ginc.org/v1/nations')

Nations API Response

[
  {
    "ginc_id": "GINC-NATN-GBR0-0000",
    "name": "United Kingdom",
    "description": "Advanced economy and global financial centre.",
    "nation_category": "standard",
    "nation_category_justification": "Population ~68 million; major global economy",
    "nation_three_letter_code": "GBR",
    "nation_two_letter_code": "GB"
  },
  {
    "ginc_id": "GINC-NATN-SGP0-0000",
    "name": "Singapore",
    "description": "Global financial and logistics hub.",
    "nation_category": "sids",
    "nation_category_justification": "On UN SIDS list; small island city-state despite wealth",
    "nation_three_letter_code": "SGP",
    "nation_two_letter_code": "SG"
  }
]

Capabilities