# Country & Currency Endpoints {#country--currency-endpoints}


Reference data endpoints for countries and currencies.


## Country Endpoints {#country-endpoints}



### Base Path: `/api/country` {#base-path-apicountry}



### List Countries {#list-countries}


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

Returns all available countries with ISO codes.

**Response:**

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


### Find by ISO Code {#find-by-iso-code}


```
GET /api/country?where={"isoCode":"US"}
Authorization: Bearer {token}
```


## Currency Endpoints {#currency-endpoints}



### Base Path: `/api/currency` {#base-path-apicurrency}



### List Currencies {#list-currencies}


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

Returns all available currencies with ISO codes.

**Response:**

```json
{
  "items": [
    { "id": "uuid", "isoCode": "USD", "currency": "US Dollar" },
    { "id": "uuid", "isoCode": "EUR", "currency": "Euro" }
  ],
  "total": 160
}
```


## Notes {#notes}


- Countries and currencies are seeded during initial setup
- These are reference/lookup tables — no CRUD operations needed
- Used by organization settings, invoices, and payments


## Related Pages {#related-pages}


- [Organization Endpoints](https://sourcey-gauzy.pages.dev/api/organization-endpoints/index.md) — org currency settings
- [Invoice Endpoints](https://sourcey-gauzy.pages.dev/api/invoice-endpoints/index.md) — invoice currency
- [Payment Endpoints](https://sourcey-gauzy.pages.dev/api/payment-endpoints/index.md) — payment currency