# Country Endpoints {#country-endpoints}


Manage countries for business configuration.


## Base Path {#base-path}


```
/api/country
```


## Endpoints {#endpoints}



### List Countries {#list-countries}


```
GET /api/country
Authorization: Bearer {token}
```

**Response:**

```json
{
  "items": [
    { "id": "uuid", "isoCode": "US", "country": "United States" },
    { "id": "uuid", "isoCode": "GB", "country": "United Kingdom" },
    { "id": "uuid", "isoCode": "DE", "country": "Germany" }
  ],
  "total": 250
}
```


### Get Country {#get-country}


```
GET /api/country/:id
Authorization: Bearer {token}
```


## System Countries {#system-countries}


All 250+ countries are seeded automatically during initial setup. Countries are used for:

- Organization address
- Employee location
- Contact/client addresses
- Tax and compliance rules
- Holiday calendar imports


## Related Pages {#related-pages}


- [Currency Endpoints](https://sourcey-gauzy.pages.dev/api/currency-endpoints/index.md) — currency API
- [Organization Settings](https://sourcey-gauzy.pages.dev/admin/organization-setup/index.md) — org config