---
title: "Country instability index"
description: "Returns a country's Conflict Indicators Index (CII) score, baseline, delta, and components. Accepts a bearer API key or [x402 payment](https://y2.dev/docs/api/x402). Without a key, read the `402` challenge in `PAYMENT-REQUIRED`. Retry with `PAYMENT-SIGNATURE`."
canonical: https://y2.dev/docs/api/reference/osint/getCountryCII/
---

Endpoint Reference[OSINT](https://y2.dev/docs/api/reference/osint)

# Country instability index

Returns a country's Conflict Indicators Index (CII) score, baseline, delta, and components. Accepts a bearer API key or \[x402 payment]\(https\://y2.dev/docs/api/x402). Without a key, read the \`402\` challenge in \`PAYMENT-REQUIRED\`. Retry with \`PAYMENT-SIGNATURE\`.

`GET https://api.y2.dev/api/v1/osint/countries/{countryCode}/cii`

- Operation ID: `getCountryCII`
- Required scopes: `osint:read`
- Accepts x402 pay-per-request payment
- Contract: https://y2.dev/openapi.json

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `countryCode` | path | string | Yes | ISO 3166-1 alpha-2 country code |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | Country instability index | `CountryCIIResponse` |
| 400 | Invalid request parameters |  |
| 401 | Missing or invalid API key |  |
| 402 | x402 payment required | `X402PaymentRequiredResponse` |
| 403 | Insufficient permissions or access denied |  |
| 404 | Conflict-indicator data is not available for this country |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data` | object |  |
| `data.source` | `RecordSource` | Where a record came from, how Y2 obtained it, and when. |
| `data.countryCode` | string | ISO alpha-2 country code |
| `data.countryName` | string | Country display name |
| `data.value` | number | Current instability index (0-100) |
| `data.baseline` | number | Baseline instability score for this country |
| `data.delta` | number | Change from baseline |
| `data.components` | object | Breakdown of instability components |
| `data.computedAt` | integer (int64) | Computation time as Unix timestamp (milliseconds) |
| `data.computedAtISO` | string (date-time) | Computation time as ISO 8601 string |
| `meta` | object |  |
| `meta.countryCode` | string |  |
