Firefly III API

v6.7.8

Contact: james@firefly-iii.org

Base URLs
https://{installation}/apiYour Firefly III installation
installation
default firefly.example.com. Your installation's host.
https://demo.firefly-iii.org/apiFirefly III demo site (refuses command-line clients)

The Firefly III REST API: every endpoint of Firefly III v6.7.8. Requests go to /api on your own installation. How to use the API shows how to create the OAuth client or Personal Access Token they need, and the API reference guide explains the currency fields, configuration values and webhooks.

Please keep in mind that the demo site does not accept requests from curl, colly, wget, etc. You must use a browser or a tool like Insomnia to make your test requests.

Please report any bugs or issues on GitHub. This file was last generated on 2026-10-19 @ 07:39:02 (Europe/Amsterdam).

Authentication

firefly_iii_authoauth2

OAuth2 authorization code flow. Create a client on your installation's /profile page; it authorizes at /oauth/authorize and issues tokens at /oauth/token there. The URLs below are the demo site's. How to use the API walks through it.

authorizationCode
Authorization URL
https://demo.firefly-iii.org/oauth/authorize
Token URL
https://demo.firefly-iii.org/oauth/token
local_bearer_authhttp

A Personal Access Token, sent as a bearer token. Create one on your installation under Options > Profile > OAuth > Personal Access Tokens.

Scheme: bearer

System

Configuration

These endpoints allow you to manage and update the Firefly III configuration. You need to have the "owner" role to update configuration.

Accounts

Endpoints that deliver all of the user's asset, expense and other accounts (and the metadata) together with related transactions, piggy banks and other objects. Also delivers endpoints for CRUD operations for accounts.

Budgets

Available budgets

available_budgets

Endpoints to manage the total available amount that the user has made available to themselves. Used in periodic budgeting.

Object groups

object_groups

Endpoints to control and manage all of the user's object groups. Can only be created in conjunction with another object (for example a piggy bank) and will auto-delete when no other items are linked to it.

Summary

These endpoints deliver summaries, like sums, lists of numbers and other processed information. Mainly used for the main dashboard and pretty specific for Firefly III itself.

Preferences

These endpoints can be used to manage the user's preferences, including some hidden ones.

Financial administrations

user_groups

User groups are the objects around which "financial administrations" are built.

Users

Use these endpoints to manage the users registered within Firefly III. You need to have the "owner" role to access these endpoints.

Models