This is the official documentation of the Firefly III API. You can find accompanying documentation on the website of Firefly III itself (see below). Please report any bugs or issues. This version of the API is live from version v4.7.9 and onwards. You may use the \"Authorize\" button to try the API below.
This API client was generated by the OpenAPI Generator project. By using the openapi-spec from a remote server, you can easily generate an API client.
Put the package under your project folder and add the following to Cargo.toml under [dependencies]:
firefly-iii = "0.1.0-alpha.4"
All URIs are relative to https://demo.firefly-iii.org
Class | Method | HTTP request | Description ------------ | ------------- | ------------- | ------------- AboutApi | getabout | GET /api/v1/about | System information end point. *AboutApi* | getcurrentuser | GET /api/v1/about/user | Currently authenticated user endpoint. *AccountsApi* | deleteaccount | DELETE /api/v1/accounts/{id} | Permanently delete account. AccountsApi | getaccount | GET /api/v1/accounts/{id} | Get single account. *AccountsApi* | listaccount | GET /api/v1/accounts | List all accounts. AccountsApi | listpiggybankbyaccount | GET /api/v1/accounts/{id}/piggybanks | List all piggy banks related to the account. *AccountsApi* | listtransactionbyaccount | GET /api/v1/accounts/{id}/transactions | List all transactions related to the account. AccountsApi | storeaccount | POST /api/v1/accounts | Create new account. *AccountsApi* | updateaccount | PUT /api/v1/accounts/{id} | Update existing account. AttachmentsApi | deleteattachment | DELETE /api/v1/attachments/{id} | Delete an attachment. *AttachmentsApi* | downloadattachment | GET /api/v1/attachments/{id}/download | Download a single attachment. AttachmentsApi | getattachment | GET /api/v1/attachments/{id} | Get a single attachment. *AttachmentsApi* | listattachment | GET /api/v1/attachments | List all attachments. AttachmentsApi | storeattachment | POST /api/v1/attachments | Store a new attachment. *AttachmentsApi* | updateattachment | PUT /api/v1/attachments/{id} | Update existing attachment. AttachmentsApi | uploadattachment | POST /api/v1/attachments/{id}/upload | Upload an attachment. *AvailableBudgetsApi* | deleteavailablebudget | DELETE /api/v1/availablebudgets/{id} | Delete an available budget. AvailableBudgetsApi | getavailablebudget | GET /api/v1/availablebudgets/{id} | Get a single available budget. *AvailableBudgetsApi* | listavailablebudget | GET /api/v1/availablebudgets | List all available budget amounts. AvailableBudgetsApi | storeavailablebudget | POST /api/v1/availablebudgets | Store a new available budget *AvailableBudgetsApi* | updateavailablebudget | PUT /api/v1/availablebudgets/{id} | Update existing available budget, to change for example the date range of the amount or the amount itself. BillsApi | deletebill | DELETE /api/v1/bills/{id} | Delete a bill. *BillsApi* | getbill | GET /api/v1/bills/{id} | Get a single bill. BillsApi | listattachmentbybill | GET /api/v1/bills/{id}/attachments | List all attachments uploaded to the bill. *BillsApi* | listbill | GET /api/v1/bills | List all bills. BillsApi | listrulebybill | GET /api/v1/bills/{id}/rules | List all rules associated with the bill. *BillsApi* | listtransactionbybill | GET /api/v1/bills/{id}/transactions | List all transactions associated with the bill. BillsApi | storebill | POST /api/v1/bills | Store a new bill *BillsApi* | updatebill | PUT /api/v1/bills/{id} | Update existing bill. BudgetsApi | deletebudget | DELETE /api/v1/budgets/{id} | Delete a budget. *BudgetsApi* | deletebudgetlimit | DELETE /api/v1/budgets/limits/{id} | Delete a budget limit. *BudgetsApi* | getbudget | GET /api/v1/budgets/{id} | Get a single budget. BudgetsApi | getbudgetlimit | GET /api/v1/budgets/limits/{id} | Get single budget limit. BudgetsApi | listbudget | GET /api/v1/budgets | List all budgets. *BudgetsApi* | listbudgetlimitbybudget | GET /api/v1/budgets/{id}/limits | Get all limits *BudgetsApi* | listtransactionbybudget | GET /api/v1/budgets/{id}/transactions | All transactions to a budget. BudgetsApi | listtransactionbybudgetlimit | GET /api/v1/budgets/limits/{id}/transactions | List all transactions by a budget limit ID. BudgetsApi | storebudget | POST /api/v1/budgets | Store a new budget *BudgetsApi* | storebudgetlimit | POST /api/v1/budgets/{id}/limits | Store new budget limit. *BudgetsApi* | updatebudget | PUT /api/v1/budgets/{id} | Update existing budget. BudgetsApi | updatebudgetlimit | PUT /api/v1/budgets/limits/{id} | Update existing budget limit. CategoriesApi | deletecategory | DELETE /api/v1/categories/{id} | Delete a category. *CategoriesApi* | getcategory | GET /api/v1/categories/{id} | Get a single category. CategoriesApi | listcategory | GET /api/v1/categories | List all categories. *CategoriesApi* | listtransactionbycategory | GET /api/v1/categories/{id}/transactions | List all transactions in a category. CategoriesApi | storecategory | POST /api/v1/categories | Store a new category *CategoriesApi* | updatecategory | PUT /api/v1/categories/{id} | Update existing category. ChartsApi | getchartaboverview | GET /api/v1/chart/ab/overview/{id} | Dashboard chart with an overview of the available budget. *ChartsApi* | getchartaccountexpense | GET /api/v1/chart/account/expense | Dashboard chart with expense account balance information. ChartsApi | getchartaccountoverview | GET /api/v1/chart/account/overview | Dashboard chart with asset account balance information. *ChartsApi* | getchartaccountrevenue | GET /api/v1/chart/account/revenue | Dashboard chart with revenue account balance information. ChartsApi | getchartcategoryoverview | GET /api/v1/chart/category/overview | Dashboard chart with an overview of the users categories. *ConfigurationApi* | getconfiguration | GET /api/v1/configuration | Get Firefly III system configuration. ConfigurationApi | setconfiguration | POST /api/v1/configuration/{name} | Update configuration *CurrenciesApi* | defaultcurrency | POST /api/v1/currencies/{code}/default | Make currency default currency. CurrenciesApi | deletecurrency | DELETE /api/v1/currencies/{code} | Delete a currency. *CurrenciesApi* | disablecurrency | POST /api/v1/currencies/{code}/disable | Disable a currency. CurrenciesApi | enablecurrency | POST /api/v1/currencies/{code}/enable | Enable a single currency. *CurrenciesApi* | getcurrency | GET /api/v1/currencies/{code} | Get a single currency. CurrenciesApi | listaccountbycurrency | GET /api/v1/currencies/{code}/accounts | List all accounts with this currency. *CurrenciesApi* | listavailablebudgetbycurrency | GET /api/v1/currencies/{code}/availablebudgets | List all available budgets with this currency. CurrenciesApi | listbillbycurrency | GET /api/v1/currencies/{code}/bills | List all bills with this currency. *CurrenciesApi* | listbudgetlimitbycurrency | GET /api/v1/currencies/{code}/budgetlimits | List all budget limits with this currency CurrenciesApi | listcurrency | GET /api/v1/currencies | List all currencies. *CurrenciesApi* | listexchangeratebycurrency | GET /api/v1/currencies/{code}/cer | List all known exchange rates with (from or to) this currency. *CurrenciesApi* | listrecurrencebycurrency | GET /api/v1/currencies/{code}/recurrences | List all recurring transactions with this currency. CurrenciesApi | listrulebycurrency | GET /api/v1/currencies/{code}/rules | List all rules with this currency. *CurrenciesApi* | listtransactionbycurrency | GET /api/v1/currencies/{code}/transactions | List all transactions with this currency. CurrenciesApi | storecurrency | POST /api/v1/currencies | Store a new currency *CurrenciesApi* | updatecurrency | PUT /api/v1/currencies/{code} | Update existing currency. CurrencyExchangeRatesApi | getexchangerate | GET /api/v1/cer | Get an exchange rate. ImportApi | getimport | GET /api/v1/import/{key} | Show info on a single import *ImportApi* | listimport | GET /api/v1/import/list | List al imports ImportApi | listtransactionbyimport | GET /api/v1/import/{key}/transactions | List all transactions related to the import job. The correlation is made through the tag. *LinksApi* | deletelinktype | DELETE /api/v1/linktypes/{id} | Permanently delete link type. LinksApi | deletetransactionlink | DELETE /api/v1/transactionlinks/{id} | Permanently delete link between transactions. *LinksApi* | getlinktype | GET /api/v1/linktypes/{id} | Get single a link type. LinksApi | gettransactionlink | GET /api/v1/transactionlinks/{id} | Get a single link. *LinksApi* | listlinktype | GET /api/v1/linktypes | List all types of links. LinksApi | listtransactionbylinktype | GET /api/v1/linktypes/{id}/transactions | List all transactions under this link type. *LinksApi* | listtransactionlink | GET /api/v1/transactionlinks | List all transaction links. LinksApi | storelinktype | POST /api/v1/linktypes | Create a new link type *LinksApi* | storetransactionlink | POST /api/v1/transactionlinks | Create a new link between transactions LinksApi | updatelinktype | PUT /api/v1/linktypes/{id} | Update existing link type. *LinksApi* | updatetransactionlink | PUT /api/v1/transactionlinks/{id} | Update an existing link between transactions. PiggyBanksApi | deletepiggybank | DELETE /api/v1/piggybanks/{id} | Delete a piggy bank. *PiggyBanksApi* | getpiggybank | GET /api/v1/piggybanks/{id} | Get a single piggy bank. PiggyBanksApi | listeventbypiggybank | GET /api/v1/piggybanks/{id}/events | List all events linked to a piggy bank. *PiggyBanksApi* | listpiggybank | GET /api/v1/piggybanks | List all piggy banks. PiggyBanksApi | storepiggybank | POST /api/v1/piggybanks | Store a new piggy bank *PiggyBanksApi* | updatepiggybank | PUT /api/v1/piggybanks/{id} | Update existing piggy bank. PreferencesApi | getpreference | GET /api/v1/preferences/{name} | Return a single preference. *PreferencesApi* | listpreference | GET /api/v1/preferences | List all users preferences. PreferencesApi | updatepreference | PUT /api/v1/preferences/{name} | Update preference *RecurrencesApi* | deleterecurrence | DELETE /api/v1/recurrences/{id} | Delete a recurring transaction. RecurrencesApi | getrecurrence | GET /api/v1/recurrences/{id} | Get a single recurring transaction. *RecurrencesApi* | listrecurrence | GET /api/v1/recurrences | List all recurring transactions. RecurrencesApi | listtransactionbyrecurrence | GET /api/v1/recurrences/{id}/transactions | List all transactions created by a recurring transaction. *RecurrencesApi* | storerecurrence | POST /api/v1/recurrences | Store a new recurring transaction RecurrencesApi | triggerrecurrence | POST /api/v1/recurrences/trigger | Trigger the creation of recurring transactions (like a cron job). *RecurrencesApi* | updaterecurrence | PUT /api/v1/recurrences/{id} | Update existing recurring transaction. RuleGroupsApi | deleterulegroup | DELETE /api/v1/rulegroups/{id} | Delete a rule group. *RuleGroupsApi* | firerulegroup | POST /api/v1/rulegroups/{id}/trigger | Fire the rule group on your transactions. RuleGroupsApi | getrulegroup | GET /api/v1/rulegroups/{id} | Get a single rule group. *RuleGroupsApi* | listrulebygroup | GET /api/v1/rulegroups/{id}/rules | List rules in this rule group. *RuleGroupsApi* | listrulegroup | GET /api/v1/rulegroups | List all rule groups. RuleGroupsApi | storerulegroup | POST /api/v1/rulegroups | Store a new rule group. *RuleGroupsApi* | testrulegroup | GET /api/v1/rulegroups/{id}/test | Test which transactions would be hit by the rule group. No changes will be made. RuleGroupsApi | updaterulegroup | PUT /api/v1/rulegroups/{id} | Update existing rule group. *RulesApi* | deleterule | DELETE /api/v1/rules/{id} | Delete an rule. RulesApi | firerule | POST /api/v1/rules/{id}/trigger | Fire the rule on your transactions. *RulesApi* | getrule | GET /api/v1/rules/{id} | Get a single rule. RulesApi | listrule | GET /api/v1/rules | List all rules. *RulesApi* | storerule | POST /api/v1/rules | Store a new rule RulesApi | testrule | GET /api/v1/rules/{id}/test | Test which transactions would be hit by the rule. No changes will be made. *RulesApi* | updaterule | PUT /api/v1/rules/{id} | Update existing rule. SummaryApi | getbasicsummary | GET /api/v1/summary/basic | Returns basic sums of the users data. TagsApi | deletetag | DELETE /api/v1/tags/{tagid} | Delete an tag. TagsApi | gettag | GET /api/v1/tags/{tagid} | Get a single tag. TagsApi | gettagcloud | GET /api/v1/tag-cloud | Returns a basic tag cloud. TagsApi | listtag | GET /api/v1/tags | List all tags. *TagsApi* | listtransactionbytag | GET /api/v1/tags/{tagid}/transactions | List all transactions with this tag. *TagsApi* | storetag | POST /api/v1/tags | Store a new tag TagsApi | updatetag | PUT /api/v1/tags/{tagid} | Update existing tag. TransactionsApi | deletetransaction | DELETE /api/v1/transactions/{id} | Delete a transaction. *TransactionsApi* | gettransaction | GET /api/v1/transactions/{id} | Get a single transaction. TransactionsApi | gettransactionbyjournal | GET /api/v1/transaction-journals/{id} | Get a single transaction, based on one of the underlying transaction journals. *TransactionsApi* | listattachmentbytransaction | GET /api/v1/transactions/{id}/attachments | Lists all attachments. TransactionsApi | listeventbytransaction | GET /api/v1/transactions/{id}/piggybankevents | Lists all piggy bank events. *TransactionsApi* | listtransaction | GET /api/v1/transactions | List all the user's transactions. TransactionsApi | storetransaction | POST /api/v1/transactions | Store a new transaction *TransactionsApi* | updatetransaction | PUT /api/v1/transactions/{id} | Update existing transaction. UsersApi | deleteuser | DELETE /api/v1/users/{id} | Delete a user. *UsersApi* | getuser | GET /api/v1/users/{id} | Get a single user. UsersApi | listuser | GET /api/v1/users | List all users. *UsersApi* | storeuser | POST /api/v1/users | Store a new user UsersApi | update_user | PUT /api/v1/users/{id} | Update an existing user's information.
To get access to the crate's generated documentation, use:
cargo doc --open
thegrumpydictator@gmail.com