Adding sovereign state and new flag

* Adding sovereign state, the sovereign state that governs the territory
* flag is now the object containing the png, svg, alt and **emoji**
This commit is contained in:
Alejandro Matos
2026-02-25 22:26:34 -05:00
parent c5f8c84307
commit 43f399832c
12 changed files with 3660 additions and 3353 deletions
+15
View File
@@ -18,6 +18,7 @@ Complete reference for all fields returned by the v4 API (`/v4`). The v4 API res
| `independent` | Boolean | ISO 3166-1 sovereignty status |
| `status` | String | ISO 3166-1 assignment status |
| `unMember` | Boolean | UN member state |
| `sovereignState` | String | ★ cca3 of the governing sovereign state, or `""` |
| `currencies` | List\<Object\> | Official currencies |
| `idd` | Object | International direct dialling info |
| `callingCodes` | List\<String\> | ★ Full international calling codes |
@@ -194,6 +195,19 @@ Complete reference for all fields returned by the v4 API (`/v4`). The v4 API res
---
#### `sovereignState` ★ New in v4
**Type:** String
**Description:** The `cca3` code of the sovereign state that governs this territory. Empty string (`""`) for independent countries. Populated only for non-independent territories (where `independent` is `false`).
```json
"sovereignState": "NLD"
```
> **Examples:** Aruba → `"NLD"`, Gibraltar → `"GBR"`, Puerto Rico → `"USA"`, Hong Kong → `"CHN"`, Greenland → `"DNK"`.
---
### Geography
---
@@ -857,6 +871,7 @@ The following fields are **not present in v3.1** and were introduced in v4:
| `hdi` | Human Development Index score |
| `nationalHoliday` | National/independence day date |
| `anthem` | Name of the national anthem |
| `sovereignState` | cca3 of the governing sovereign state (`""` for independent) |
### Shape changes from v3.1