go-firefly3/docs/AvailableBudgetsApi.md
2024-05-11 14:45:50 +03:00

3.7 KiB

{{classname}}

All URIs are relative to https://demo.firefly-iii.org/api

Method HTTP request Description
GetAvailableBudget Get /v1/available-budgets/{id} Get a single available budget.
ListAvailableBudget Get /v1/available-budgets List all available budget amounts.

GetAvailableBudget

AvailableBudgetSingle GetAvailableBudget(ctx, id, optional) Get a single available budget.

Get a single available budget, by ID.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
id string The ID of the available budget.
optional *AvailableBudgetsApiGetAvailableBudgetOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a AvailableBudgetsApiGetAvailableBudgetOpts struct

Name Type Description Notes

xTraceId | optional.Interface of string| Unique identifier associated with this request. |

Return type

AvailableBudgetSingle

Authorization

firefly_iii_auth, local_bearer_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json, application/vnd.api+json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ListAvailableBudget

AvailableBudgetArray ListAvailableBudget(ctx, optional) List all available budget amounts.

Firefly III allows users to set the amount that is available to be budgeted in so-called "available budgets". For example, the user could have 1200,- available to be divided during the coming month. This amount is used on the /budgets page. This endpoint returns all of these amounts and the periods for which they are set.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *AvailableBudgetsApiListAvailableBudgetOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a AvailableBudgetsApiListAvailableBudgetOpts 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.
end optional.String A date formatted YYYY-MM-DD.

Return type

AvailableBudgetArray

Authorization

firefly_iii_auth, local_bearer_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json, application/vnd.api+json

[Back to top] [Back to API list] [Back to Model list] [Back to README]