# Currency Endpoints {#currency-endpoints}


Manage currencies for organizations.


## Base Path {#base-path}


```
/api/currency
```


## Endpoints {#endpoints}



### List Currencies {#list-currencies}


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

**Response:**

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


### Create Currency {#create-currency}


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

```json
{ "isoCode": "BTC", "currency": "Bitcoin" }
```


### Update Currency {#update-currency}


```
PUT /api/currency/:id
Authorization: Bearer {token}
```


### Delete Currency {#delete-currency}


```
DELETE /api/currency/:id
Authorization: Bearer {token}
```


## Default Currencies {#default-currencies}


System seeds include 150+ world currencies (ISO 4217).


## Related Pages {#related-pages}


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