Supported Currencies

Lunch Money supports a wide range of currencies for transactions and accounts. All currency values in the API use three-letter lowercase currency codes in ISO 4217 format.

Currency Code Format

Currency codes must be:

• Three letters
• Lowercase
• Valid ISO 4217 currency codes

Supported Currencies

The following currencies are currently supported in Lunch Money:

Using Currencies in the API

When creating or updating transactions, accounts, or other resources that include currency information, use the three-letter lowercase currency code:

// Create a transaction with a specific currency
const transaction = {
  date: "2024-01-15",
  amount: "100.50",
  currency: "eur",  // Euro
  payee: "Coffee Shop",
  category_id: 83
};

const response = await fetch('https://api.lunchmoney.dev/v2/transactions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(transaction)
});

import requests

# Create a transaction with a specific currency
transaction = {
    "date": "2024-01-15",
    "amount": "100.50",
    "currency": "eur",  # Euro
    "payee": "Coffee Shop",
    "category_id": 83
}

response = requests.post(
    'https://api.lunchmoney.dev/v2/transactions',
    headers={
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
        'Content-Type': 'application/json'
    },
    json=transaction
)

curl -X POST 'https://api.lunchmoney.dev/v2/transactions' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "date": "2024-01-15",
    "amount": "100.50",
    "currency": "eur",
    "payee": "Coffee Shop",
    "category_id": 83
  }'

Default Currency

If you don't specify a currency when creating a transaction or account, Lunch Money will default to your account's primary currency. You can check your primary currency by calling the GET /v2/me endpoint.

Currency Validation

The API validates that currency codes match the supported list. If you provide an unsupported currency code, you'll receive a validation error:

{
  "message": "Request Validation Failure",
  "errors": [
    {
      "errMsg": "Invalid currency code",
      "instancePath": "/currency",
      "schemaPath": "#/properties/currency/enum"
    }
  ]
}

Requesting New Currencies

If your currency is missing from the supported list, please let us know via email at support@lunchmoney.app and we'll work on getting it added.