Introduction

Lunch Money Developer Docs

Welcome to the Lunch Money developer documentation. This site covers the v2 API — the current generation of the Lunch Money API — along with guides, a reference for the legacy v1 API, and tools for exploring the API without touching real data.

Alpha Release
The v2 API is in open alpha. It is subject to change during this review period and bugs may exist. We strongly encourage using the mock service or a test budget with sample data as your first step.

Getting Started

The v2 API is available at:

https://api.lunchmoney.dev/v2

Get your access token from the Lunch Money app developers page and include it as a Bearer token in every request:

Authorization: Bearer YOUR_ACCESS_TOKEN

See the Getting Started guide for a full walkthrough, including how to create a test budget and make your first request.

Trying the API Without Real Data

The interactive API reference lets you make live API requests directly from the documentation — including a static mock server you can use to explore the API without an access token or any risk to real data.

Open the API Reference and click the Server dropdown near the top of the page. Select https://mock.lunchmoney.dev/v2. Server dropdown with mock server selected

Set your Bearer Token to any string of 11 or more characters — no real token needed. You can enter it in the server panel that appears after selecting the mock server, or inside any endpoint's Authentication section. Bearer token field with a placeholder value entered

Client Libraries & SDKs

An official TypeScript SDK is available:

Looking for a Python SDK or a client in another language? The lunchmoney-clients project provides a Python SDK and can generate clients for other languages from the OpenAPI spec.

Migrating from v1

The v2 API is not backwards compatible with v1. See the Migration Guide to understand what changed and plan your migration.

The v1 API remains available at https://api.lunchmoney.dev/v1 and its documentation is available here. New projects should use v2.

Acknowledgments

If you provided feedback during the API design process — thank you. We built this based on what the community asked for.

Join the conversation in the Lunch Money Discord in the #developer-api channel.

Useful links: