26 KiB
{{classname}}
All URIs are relative to https://demo.firefly-iii.org/api
Method | HTTP request | Description |
---|---|---|
DefaultCurrency | Post /v1/currencies/{code}/default | Make currency default currency. |
DeleteCurrency | Delete /v1/currencies/{code} | Delete a currency. |
DisableCurrency | Post /v1/currencies/{code}/disable | Disable a currency. |
EnableCurrency | Post /v1/currencies/{code}/enable | Enable a single currency. |
GetCurrency | Get /v1/currencies/{code} | Get a single currency. |
GetDefaultCurrency | Get /v1/currencies/default | Get the user's default currency. |
ListAccountByCurrency | Get /v1/currencies/{code}/accounts | List all accounts with this currency. |
ListAvailableBudgetByCurrency | Get /v1/currencies/{code}/available-budgets | List all available budgets with this currency. |
ListBillByCurrency | Get /v1/currencies/{code}/bills | List all bills with this currency. |
ListBudgetLimitByCurrency | Get /v1/currencies/{code}/budget_limits | List all budget limits with this currency |
ListCurrency | Get /v1/currencies | List all currencies. |
ListRecurrenceByCurrency | Get /v1/currencies/{code}/recurrences | List all recurring transactions with this currency. |
ListRuleByCurrency | Get /v1/currencies/{code}/rules | List all rules with this currency. |
ListTransactionByCurrency | Get /v1/currencies/{code}/transactions | List all transactions with this currency. |
StoreCurrency | Post /v1/currencies | Store a new currency |
UpdateCurrency | Put /v1/currencies/{code} | Update existing currency. |
DefaultCurrency
CurrencySingle DefaultCurrency(ctx, code, optional) Make currency default currency.
Make this currency the default currency for the user. If the currency is not enabled, it will be enabled as well.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
code | string | The currency code. | |
optional | *CurrenciesApiDefaultCurrencyOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CurrenciesApiDefaultCurrencyOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
DeleteCurrency
DeleteCurrency(ctx, code, optional) Delete a currency.
Delete a currency.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
code | string | The currency code. | |
optional | *CurrenciesApiDeleteCurrencyOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CurrenciesApiDeleteCurrencyOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. |
Return type
(empty response body)
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
DisableCurrency
CurrencySingle DisableCurrency(ctx, code, optional) Disable a currency.
Disable a currency.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
code | string | The currency code. | |
optional | *CurrenciesApiDisableCurrencyOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CurrenciesApiDisableCurrencyOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
EnableCurrency
CurrencySingle EnableCurrency(ctx, code, optional) Enable a single currency.
Enable a single currency.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
code | string | The currency code. | |
optional | *CurrenciesApiEnableCurrencyOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CurrenciesApiEnableCurrencyOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetCurrency
CurrencySingle GetCurrency(ctx, code, optional) Get a single currency.
Get a single currency.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
code | string | The currency code. | |
optional | *CurrenciesApiGetCurrencyOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CurrenciesApiGetCurrencyOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetDefaultCurrency
CurrencySingle GetDefaultCurrency(ctx, optional) Get the user's default currency.
Get the user's default currency.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
optional | *CurrenciesApiGetDefaultCurrencyOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CurrenciesApiGetDefaultCurrencyOpts struct
Name | Type | Description | Notes |
---|---|---|---|
xTraceId | optional.Interface of string | Unique identifier associated with this request. |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
ListAccountByCurrency
AccountArray ListAccountByCurrency(ctx, code, optional) List all accounts with this currency.
List all accounts with this currency.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
code | string | The currency code. | |
optional | *CurrenciesApiListAccountByCurrencyOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CurrenciesApiListAccountByCurrencyOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. | limit | optional.Int32| Number of items per page. The default pagination is per 50 items. | page | optional.Int32| Page number. The default pagination is per 50 items. | date | optional.String| A date formatted YYYY-MM-DD. When added to the request, Firefly III will show the account's balance on that day. | type_ | optional.Interface of AccountTypeFilter| Optional filter on the account type(s) returned |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
ListAvailableBudgetByCurrency
AvailableBudgetArray ListAvailableBudgetByCurrency(ctx, code, optional) List all available budgets with this currency.
List all available budgets with this currency.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
code | string | The currency code. | |
optional | *CurrenciesApiListAvailableBudgetByCurrencyOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CurrenciesApiListAvailableBudgetByCurrencyOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. | limit | optional.Int32| Number of items per page. The default pagination is per 50 items. | page | optional.Int32| Page number. The default pagination is per 50 items. |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
ListBillByCurrency
BillArray ListBillByCurrency(ctx, code, optional) List all bills with this currency.
List all bills with this currency.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
code | string | The currency code. | |
optional | *CurrenciesApiListBillByCurrencyOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CurrenciesApiListBillByCurrencyOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. | limit | optional.Int32| Number of items per page. The default pagination is per 50 items. | page | optional.Int32| Page number. The default pagination is per 50 items. |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
ListBudgetLimitByCurrency
BudgetLimitArray ListBudgetLimitByCurrency(ctx, code, optional) List all budget limits with this currency
List all budget limits with this currency
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
code | string | The currency code. | |
optional | *CurrenciesApiListBudgetLimitByCurrencyOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CurrenciesApiListBudgetLimitByCurrencyOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. | limit | optional.Int32| Number of items per page. The default pagination is per 50 items. | page | optional.Int32| Page number. The default pagination is per 50 items. | start | optional.String| Start date for the budget limit list. | end | optional.String| End date for the budget limit list. |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
ListCurrency
CurrencyArray ListCurrency(ctx, optional) List all currencies.
List all currencies.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
optional | *CurrenciesApiListCurrencyOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CurrenciesApiListCurrencyOpts struct
Name | Type | Description | Notes |
---|---|---|---|
xTraceId | optional.Interface of string | Unique identifier associated with this request. | |
limit | optional.Int32 | Number of items per page. The default pagination is per 50 items. | |
page | optional.Int32 | Page number. The default pagination is per 50 items. |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
ListRecurrenceByCurrency
RecurrenceArray ListRecurrenceByCurrency(ctx, code, optional) List all recurring transactions with this currency.
List all recurring transactions with this currency.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
code | string | The currency code. | |
optional | *CurrenciesApiListRecurrenceByCurrencyOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CurrenciesApiListRecurrenceByCurrencyOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. | limit | optional.Int32| Number of items per page. The default pagination is per 50 items. | page | optional.Int32| Page number. The default pagination is per 50 items. |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
ListRuleByCurrency
RuleArray ListRuleByCurrency(ctx, code, optional) List all rules with this currency.
List all rules with this currency.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
code | string | The currency code. | |
optional | *CurrenciesApiListRuleByCurrencyOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CurrenciesApiListRuleByCurrencyOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. | limit | optional.Int32| Number of items per page. The default pagination is per 50 items. | page | optional.Int32| Page number. The default pagination is per 50 items. |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
ListTransactionByCurrency
TransactionArray ListTransactionByCurrency(ctx, code, optional) List all transactions with this currency.
List all transactions with this currency.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
code | string | The currency code. | |
optional | *CurrenciesApiListTransactionByCurrencyOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CurrenciesApiListTransactionByCurrencyOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. | limit | optional.Int32| Number of items per page. The default pagination is per 50 items. | page | optional.Int32| Page number. The default pagination is per 50 items. | start | optional.String| A date formatted YYYY-MM-DD, to limit the list of transactions. | end | optional.String| A date formatted YYYY-MM-DD, to limit the list of transactions. | type_ | optional.Interface of TransactionTypeFilter| Optional filter on the transaction type(s) returned |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: Not defined
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
StoreCurrency
CurrencySingle StoreCurrency(ctx, body, enabled, default_, code, name, symbol, decimalPlaces, optional) Store a new currency
Creates a new currency. The data required can be submitted as a JSON body or as a list of parameters.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
body | CurrencyStore | JSON array or key=value pairs with the necessary currency information. See the model for the exact specifications. | |
enabled | bool | ||
default_ | bool | ||
code | string | ||
name | string | ||
symbol | string | ||
decimalPlaces | int32 | ||
optional | *CurrenciesApiStoreCurrencyOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CurrenciesApiStoreCurrencyOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: application/json, application/x-www-form-urlencoded
- Accept: application/vnd.api+json, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
UpdateCurrency
CurrencySingle UpdateCurrency(ctx, body, enabled, default_, code, name, symbol, decimalPlaces, code, optional) Update existing currency.
Update existing currency.
Required Parameters
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
body | CurrencyUpdate | JSON array with updated currency information. See the model for the exact specifications. | |
enabled | bool | ||
default_ | bool | ||
code | string | ||
name | string | ||
symbol | string | ||
decimalPlaces | int32 | ||
code | string | The currency code. | |
optional | *CurrenciesApiUpdateCurrencyOpts | optional parameters | nil if no parameters |
Optional Parameters
Optional parameters are passed through a pointer to a CurrenciesApiUpdateCurrencyOpts struct
Name | Type | Description | Notes |
---|
xTraceId | optional.Interface of string| Unique identifier associated with this request. |
Return type
Authorization
firefly_iii_auth, local_bearer_auth
HTTP request headers
- Content-Type: application/vnd.api+json, application/x-www-form-urlencoded
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]