ynab 1.29.0 → 2.0.0.rc1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/DEVELOPMENT.md +11 -0
- data/Gemfile +8 -0
- data/Gemfile.lock +42 -0
- data/README.md +6 -6
- data/Rakefile +58 -0
- data/config.json +9 -0
- data/docs/Account.md +25 -0
- data/docs/AccountResponse.md +8 -0
- data/docs/AccountResponseData.md +8 -0
- data/docs/AccountType.md +7 -0
- data/docs/AccountWrapper.md +8 -0
- data/docs/AccountsApi.md +70 -0
- data/docs/AccountsResponse.md +8 -0
- data/docs/AccountsResponseData.md +9 -0
- data/docs/AccountsWrapper.md +9 -0
- data/docs/BudgetDetail.md +24 -0
- data/docs/BudgetDetailAllOf.md +17 -0
- data/docs/BudgetDetailResponse.md +8 -0
- data/docs/BudgetDetailResponseData.md +9 -0
- data/docs/BudgetDetailWrapper.md +9 -0
- data/docs/BudgetSettings.md +9 -0
- data/docs/BudgetSettingsResponse.md +8 -0
- data/docs/BudgetSettingsResponseData.md +8 -0
- data/docs/BudgetSettingsWrapper.md +8 -0
- data/docs/BudgetSummary.md +15 -0
- data/docs/BudgetSummaryResponse.md +8 -0
- data/docs/BudgetSummaryResponseData.md +9 -0
- data/docs/BudgetSummaryWrapper.md +9 -0
- data/docs/BudgetsApi.md +68 -0
- data/docs/BulkIdWrapper.md +8 -0
- data/docs/BulkIds.md +9 -0
- data/docs/BulkResponse.md +8 -0
- data/docs/BulkResponseData.md +8 -0
- data/docs/BulkResponseDataBulk.md +9 -0
- data/docs/BulkTransactionCreateResponse.md +8 -0
- data/docs/BulkTransactionIds.md +8 -0
- data/docs/BulkTransactions.md +8 -0
- data/docs/CategoriesApi.md +94 -0
- data/docs/CategoriesResponse.md +8 -0
- data/docs/CategoriesResponseData.md +9 -0
- data/docs/Category.md +30 -0
- data/docs/CategoryGroup.md +11 -0
- data/docs/CategoryGroupWithCategories.md +12 -0
- data/docs/CategoryGroupWithCategoriesAllOf.md +8 -0
- data/docs/CategoryGroupsWrapper.md +9 -0
- data/docs/CategoryResponse.md +8 -0
- data/docs/CategoryResponseData.md +8 -0
- data/docs/CategoryWrapper.md +9 -0
- data/docs/CurrencyFormat.md +15 -0
- data/docs/DateFormat.md +8 -0
- data/docs/DeprecatedApi.md +28 -0
- data/docs/ErrorDetail.md +10 -0
- data/docs/ErrorResponse.md +8 -0
- data/docs/HybridTransaction.md +30 -0
- data/docs/HybridTransactionAllOf.md +12 -0
- data/docs/HybridTransactionsResponse.md +8 -0
- data/docs/HybridTransactionsResponseData.md +9 -0
- data/docs/HybridTransactionsWrapper.md +8 -0
- data/docs/LoanAccountPeriodicValue.md +7 -0
- data/docs/MonthDetail.md +16 -0
- data/docs/MonthDetailAllOf.md +8 -0
- data/docs/MonthDetailResponse.md +8 -0
- data/docs/MonthDetailResponseData.md +8 -0
- data/docs/MonthDetailWrapper.md +8 -0
- data/docs/MonthSummariesResponse.md +8 -0
- data/docs/MonthSummariesResponseData.md +9 -0
- data/docs/MonthSummariesWrapper.md +9 -0
- data/docs/MonthSummary.md +15 -0
- data/docs/MonthsApi.md +49 -0
- data/docs/PatchMonthCategoryWrapper.md +8 -0
- data/docs/PatchTransactionsWrapper.md +8 -0
- data/docs/Payee.md +11 -0
- data/docs/PayeeLocation.md +12 -0
- data/docs/PayeeLocationResponse.md +8 -0
- data/docs/PayeeLocationResponseData.md +8 -0
- data/docs/PayeeLocationWrapper.md +8 -0
- data/docs/PayeeLocationsApi.md +69 -0
- data/docs/PayeeLocationsResponse.md +8 -0
- data/docs/PayeeLocationsResponseData.md +8 -0
- data/docs/PayeeLocationsWrapper.md +8 -0
- data/docs/PayeeResponse.md +8 -0
- data/docs/PayeeResponseData.md +8 -0
- data/docs/PayeeWrapper.md +8 -0
- data/docs/PayeesApi.md +49 -0
- data/docs/PayeesResponse.md +8 -0
- data/docs/PayeesResponseData.md +9 -0
- data/docs/PayeesWrapper.md +9 -0
- data/docs/PostAccountWrapper.md +8 -0
- data/docs/PostTransactionsWrapper.md +9 -0
- data/docs/PutTransactionWrapper.md +8 -0
- data/docs/SaveAccount.md +10 -0
- data/docs/SaveAccountWrapper.md +8 -0
- data/docs/SaveCategoryResponse.md +8 -0
- data/docs/SaveCategoryResponseData.md +9 -0
- data/docs/SaveMonthCategory.md +8 -0
- data/docs/SaveMonthCategoryWrapper.md +8 -0
- data/docs/SaveSubTransaction.md +12 -0
- data/docs/SaveTransaction.md +19 -0
- data/docs/SaveTransactionWithId.md +20 -0
- data/docs/SaveTransactionWithIdAllOf.md +8 -0
- data/docs/SaveTransactionWithOptionalFields.md +19 -0
- data/docs/SaveTransactionWrapper.md +8 -0
- data/docs/SaveTransactionsResponse.md +8 -0
- data/docs/SaveTransactionsResponseData.md +12 -0
- data/docs/SaveTransactionsWrapper.md +9 -0
- data/docs/ScheduledSubTransaction.md +15 -0
- data/docs/ScheduledTransactionDetail.md +23 -0
- data/docs/ScheduledTransactionDetailAllOf.md +11 -0
- data/docs/ScheduledTransactionResponse.md +8 -0
- data/docs/ScheduledTransactionResponseData.md +8 -0
- data/docs/ScheduledTransactionSummary.md +19 -0
- data/docs/ScheduledTransactionWrapper.md +8 -0
- data/docs/ScheduledTransactionsApi.md +49 -0
- data/docs/ScheduledTransactionsResponse.md +8 -0
- data/docs/ScheduledTransactionsResponseData.md +9 -0
- data/docs/ScheduledTransactionsWrapper.md +8 -0
- data/docs/SubTransaction.md +18 -0
- data/docs/TransactionDetail.md +29 -0
- data/docs/TransactionDetailAllOf.md +11 -0
- data/docs/TransactionResponse.md +8 -0
- data/docs/TransactionResponseData.md +8 -0
- data/docs/TransactionSummary.md +25 -0
- data/docs/TransactionWrapper.md +8 -0
- data/docs/TransactionsApi.md +228 -0
- data/docs/TransactionsImportResponse.md +8 -0
- data/docs/TransactionsImportResponseData.md +8 -0
- data/docs/TransactionsResponse.md +8 -0
- data/docs/TransactionsResponseData.md +9 -0
- data/docs/TransactionsWrapper.md +9 -0
- data/docs/UpdateTransaction.md +20 -0
- data/docs/UpdateTransactionsWrapper.md +8 -0
- data/docs/User.md +8 -0
- data/docs/UserApi.md +25 -0
- data/docs/UserResponse.md +8 -0
- data/docs/UserResponseData.md +8 -0
- data/docs/UserWrapper.md +8 -0
- data/examples/budget-list.rb +21 -0
- data/examples/budget-month.rb +33 -0
- data/examples/category-balance.rb +23 -0
- data/examples/create-multiple-transactions.rb +42 -0
- data/examples/create-transaction.rb +30 -0
- data/examples/update-category-budgeted.rb +25 -0
- data/examples/update-multiple-transactions.rb +20 -0
- data/lib/ynab/api/accounts_api.rb +79 -42
- data/lib/ynab/api/budgets_api.rb +69 -37
- data/lib/ynab/api/categories_api.rb +109 -61
- data/lib/ynab/api/deprecated_api.rb +33 -18
- data/lib/ynab/api/months_api.rb +50 -29
- data/lib/ynab/api/payee_locations_api.rb +74 -42
- data/lib/ynab/api/payees_api.rb +50 -29
- data/lib/ynab/api/scheduled_transactions_api.rb +50 -29
- data/lib/ynab/api/transactions_api.rb +269 -141
- data/lib/ynab/api/user_api.rb +23 -13
- data/lib/ynab/api_client.rb +98 -96
- data/lib/ynab/configuration.rb +103 -16
- data/lib/ynab/models/account.rb +118 -56
- data/lib/ynab/models/account_response.rb +54 -19
- data/lib/ynab/models/account_response_data.rb +54 -19
- data/lib/ynab/models/account_type.rb +31 -21
- data/lib/ynab/models/accounts_response.rb +54 -19
- data/lib/ynab/models/accounts_response_data.rb +55 -20
- data/lib/ynab/models/budget_detail.rb +81 -36
- data/lib/ynab/models/budget_detail_all_of.rb +320 -0
- data/lib/ynab/models/budget_detail_response.rb +54 -19
- data/lib/ynab/models/budget_detail_response_data.rb +55 -20
- data/lib/ynab/models/budget_settings.rb +57 -30
- data/lib/ynab/models/budget_settings_response.rb +54 -19
- data/lib/ynab/models/budget_settings_response_data.rb +54 -19
- data/lib/ynab/models/budget_summary.rb +64 -27
- data/lib/ynab/models/budget_summary_response.rb +54 -19
- data/lib/ynab/models/budget_summary_response_data.rb +55 -21
- data/lib/ynab/models/bulk_response.rb +54 -19
- data/lib/ynab/models/bulk_response_data.rb +54 -19
- data/lib/ynab/models/bulk_response_data_bulk.rb +55 -20
- data/lib/ynab/models/bulk_transactions.rb +54 -19
- data/lib/ynab/models/categories_response.rb +54 -19
- data/lib/ynab/models/categories_response_data.rb +55 -20
- data/lib/ynab/models/category.rb +111 -49
- data/lib/ynab/models/category_group.rb +59 -24
- data/lib/ynab/models/category_group_with_categories.rb +68 -25
- data/lib/ynab/models/{save_month_category_wrapper.rb → category_group_with_categories_all_of.rb} +67 -29
- data/lib/ynab/models/category_response.rb +54 -19
- data/lib/ynab/models/category_response_data.rb +54 -19
- data/lib/ynab/models/currency_format.rb +63 -28
- data/lib/ynab/models/date_format.rb +54 -19
- data/lib/ynab/models/error_detail.rb +56 -21
- data/lib/ynab/models/error_response.rb +54 -19
- data/lib/ynab/models/hybrid_transaction.rb +120 -47
- data/lib/ynab/models/hybrid_transaction_all_of.rb +304 -0
- data/lib/ynab/models/hybrid_transactions_response.rb +54 -19
- data/lib/ynab/models/hybrid_transactions_response_data.rb +55 -20
- data/lib/ynab/models/month_detail.rb +73 -28
- data/lib/ynab/models/{update_transactions_wrapper.rb → month_detail_all_of.rb} +66 -30
- data/lib/ynab/models/month_detail_response.rb +54 -19
- data/lib/ynab/models/month_detail_response_data.rb +54 -19
- data/lib/ynab/models/month_summaries_response.rb +54 -19
- data/lib/ynab/models/month_summaries_response_data.rb +55 -20
- data/lib/ynab/models/month_summary.rb +64 -27
- data/lib/ynab/models/patch_month_category_wrapper.rb +54 -19
- data/lib/ynab/models/patch_transactions_wrapper.rb +54 -19
- data/lib/ynab/models/payee.rb +59 -23
- data/lib/ynab/models/payee_location.rb +59 -24
- data/lib/ynab/models/payee_location_response.rb +54 -19
- data/lib/ynab/models/payee_location_response_data.rb +54 -19
- data/lib/ynab/models/payee_locations_response.rb +54 -19
- data/lib/ynab/models/payee_locations_response_data.rb +54 -19
- data/lib/ynab/models/payee_response.rb +54 -19
- data/lib/ynab/models/payee_response_data.rb +54 -19
- data/lib/ynab/models/payees_response.rb +54 -19
- data/lib/ynab/models/payees_response_data.rb +55 -20
- data/lib/ynab/models/post_account_wrapper.rb +54 -19
- data/lib/ynab/models/post_transactions_wrapper.rb +55 -20
- data/lib/ynab/models/put_transaction_wrapper.rb +54 -19
- data/lib/ynab/models/save_account.rb +78 -21
- data/lib/ynab/models/save_category_response.rb +54 -19
- data/lib/ynab/models/save_category_response_data.rb +55 -20
- data/lib/ynab/models/save_month_category.rb +54 -19
- data/lib/ynab/models/save_sub_transaction.rb +62 -23
- data/lib/ynab/models/save_transaction.rb +89 -34
- data/lib/ynab/models/save_transaction_with_id.rb +103 -47
- data/lib/ynab/models/{save_transactions_wrapper.rb → save_transaction_with_id_all_of.rb} +60 -36
- data/lib/ynab/models/save_transaction_with_optional_fields.rb +82 -34
- data/lib/ynab/models/save_transactions_response.rb +54 -19
- data/lib/ynab/models/save_transactions_response_data.rb +58 -24
- data/lib/ynab/models/scheduled_sub_transaction.rb +67 -28
- data/lib/ynab/models/scheduled_transaction_detail.rb +96 -37
- data/lib/ynab/models/scheduled_transaction_detail_all_of.rb +262 -0
- data/lib/ynab/models/scheduled_transaction_response.rb +54 -19
- data/lib/ynab/models/scheduled_transaction_response_data.rb +54 -19
- data/lib/ynab/models/scheduled_transaction_summary.rb +81 -33
- data/lib/ynab/models/scheduled_transactions_response.rb +54 -19
- data/lib/ynab/models/scheduled_transactions_response_data.rb +55 -20
- data/lib/ynab/models/sub_transaction.rb +72 -30
- data/lib/ynab/models/transaction_detail.rb +114 -45
- data/lib/ynab/models/{save_transaction_wrapper.rb → transaction_detail_all_of.rb} +102 -29
- data/lib/ynab/models/transaction_response.rb +54 -19
- data/lib/ynab/models/transaction_response_data.rb +54 -19
- data/lib/ynab/models/transaction_summary.rb +99 -41
- data/lib/ynab/models/transactions_import_response.rb +54 -19
- data/lib/ynab/models/transactions_import_response_data.rb +54 -19
- data/lib/ynab/models/transactions_response.rb +54 -19
- data/lib/ynab/models/transactions_response_data.rb +55 -20
- data/lib/ynab/models/user.rb +54 -19
- data/lib/ynab/models/user_response.rb +54 -19
- data/lib/ynab/models/user_response_data.rb +54 -19
- data/lib/ynab/version.rb +1 -1
- data/lib/ynab.rb +21 -16
- data/open_api_spec.yaml +3012 -0
- data/templates/api_client.mustache +274 -0
- data/templates/api_client_typhoeus_partial.mustache +156 -0
- data/templates/api_doc.mustache +44 -0
- data/templates/gem.mustache +84 -0
- data/templates/partial_model_generic_doc.mustache +9 -0
- data/ynab.gemspec +38 -0
- metadata +197 -90
- data/lib/ynab/models/loan_account_periodic_value.rb +0 -175
- data/lib/ynab/models/save_account_wrapper.rb +0 -189
- data/lib/ynab/models/update_transaction.rb +0 -407
- data/spec/models/transaction_detail_spec.rb +0 -11
@@ -0,0 +1,94 @@
|
|
1
|
+
# YNAB::CategoriesApi
|
2
|
+
|
3
|
+
All URIs are relative to *https://api.ynab.com/v1*
|
4
|
+
|
5
|
+
| Method | HTTP request | Description |
|
6
|
+
| ------ | ------------ | ----------- |
|
7
|
+
| [**get_categories**](CategoriesApi.md#get_categories) | **GET** /budgets/{budget_id}/categories | List categories |
|
8
|
+
| [**get_category_by_id**](CategoriesApi.md#get_category_by_id) | **GET** /budgets/{budget_id}/categories/{category_id} | Single category |
|
9
|
+
| [**get_month_category_by_id**](CategoriesApi.md#get_month_category_by_id) | **GET** /budgets/{budget_id}/months/{month}/categories/{category_id} | Single category for a specific budget month |
|
10
|
+
| [**update_month_category**](CategoriesApi.md#update_month_category) | **PATCH** /budgets/{budget_id}/months/{month}/categories/{category_id} | Update a category for a specific month |
|
11
|
+
|
12
|
+
|
13
|
+
## get_categories
|
14
|
+
|
15
|
+
> <CategoriesResponse> get_categories(budget_id, opts)
|
16
|
+
|
17
|
+
List categories
|
18
|
+
|
19
|
+
Returns all categories grouped by category group. Amounts (budgeted, activity, balance, etc.) are specific to the current budget month (UTC).
|
20
|
+
|
21
|
+
### Parameters
|
22
|
+
|
23
|
+
| Name | Type | Description | Notes |
|
24
|
+
| ---- | ---- | ----------- | ----- |
|
25
|
+
| **budget_id** | **String** | The id of the budget. \"last-used\" can be used to specify the last used budget and \"default\" can be used if default budget selection is enabled (see: https://api.ynab.com/#oauth-default-budget). | |
|
26
|
+
| **last_knowledge_of_server** | **Integer** | The starting server knowledge. If provided, only entities that have changed since `last_knowledge_of_server` will be included. | [optional] |
|
27
|
+
|
28
|
+
### Return type
|
29
|
+
|
30
|
+
[**CategoriesResponse**](CategoriesResponse.md)
|
31
|
+
|
32
|
+
|
33
|
+
## get_category_by_id
|
34
|
+
|
35
|
+
> <CategoryResponse> get_category_by_id(budget_id, category_id)
|
36
|
+
|
37
|
+
Single category
|
38
|
+
|
39
|
+
Returns a single category. Amounts (budgeted, activity, balance, etc.) are specific to the current budget month (UTC).
|
40
|
+
|
41
|
+
### Parameters
|
42
|
+
|
43
|
+
| Name | Type | Description | Notes |
|
44
|
+
| ---- | ---- | ----------- | ----- |
|
45
|
+
| **budget_id** | **String** | The id of the budget. \"last-used\" can be used to specify the last used budget and \"default\" can be used if default budget selection is enabled (see: https://api.ynab.com/#oauth-default-budget). | |
|
46
|
+
| **category_id** | **String** | The id of the category | |
|
47
|
+
|
48
|
+
### Return type
|
49
|
+
|
50
|
+
[**CategoryResponse**](CategoryResponse.md)
|
51
|
+
|
52
|
+
|
53
|
+
## get_month_category_by_id
|
54
|
+
|
55
|
+
> <CategoryResponse> get_month_category_by_id(budget_id, month, category_id)
|
56
|
+
|
57
|
+
Single category for a specific budget month
|
58
|
+
|
59
|
+
Returns a single category for a specific budget month. Amounts (budgeted, activity, balance, etc.) are specific to the current budget month (UTC).
|
60
|
+
|
61
|
+
### Parameters
|
62
|
+
|
63
|
+
| Name | Type | Description | Notes |
|
64
|
+
| ---- | ---- | ----------- | ----- |
|
65
|
+
| **budget_id** | **String** | The id of the budget. \"last-used\" can be used to specify the last used budget and \"default\" can be used if default budget selection is enabled (see: https://api.ynab.com/#oauth-default-budget). | |
|
66
|
+
| **month** | **Date** | The budget month in ISO format (e.g. 2016-12-01) (\"current\" can also be used to specify the current calendar month (UTC)) | |
|
67
|
+
| **category_id** | **String** | The id of the category | |
|
68
|
+
|
69
|
+
### Return type
|
70
|
+
|
71
|
+
[**CategoryResponse**](CategoryResponse.md)
|
72
|
+
|
73
|
+
|
74
|
+
## update_month_category
|
75
|
+
|
76
|
+
> <SaveCategoryResponse> update_month_category(budget_id, month, category_id, data)
|
77
|
+
|
78
|
+
Update a category for a specific month
|
79
|
+
|
80
|
+
Update a category for a specific month. Only `budgeted` amount can be updated.
|
81
|
+
|
82
|
+
### Parameters
|
83
|
+
|
84
|
+
| Name | Type | Description | Notes |
|
85
|
+
| ---- | ---- | ----------- | ----- |
|
86
|
+
| **budget_id** | **String** | The id of the budget. \"last-used\" can be used to specify the last used budget and \"default\" can be used if default budget selection is enabled (see: https://api.ynab.com/#oauth-default-budget). | |
|
87
|
+
| **month** | **Date** | The budget month in ISO format (e.g. 2016-12-01) (\"current\" can also be used to specify the current calendar month (UTC)) | |
|
88
|
+
| **category_id** | **String** | The id of the category | |
|
89
|
+
| **data** | [**PatchMonthCategoryWrapper**](PatchMonthCategoryWrapper.md) | The category to update. Only `budgeted` amount can be updated and any other fields specified will be ignored. | |
|
90
|
+
|
91
|
+
### Return type
|
92
|
+
|
93
|
+
[**SaveCategoryResponse**](SaveCategoryResponse.md)
|
94
|
+
|
@@ -0,0 +1,9 @@
|
|
1
|
+
# YNAB::CategoriesResponseData
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **category_groups** | [**Array<CategoryGroupWithCategories>**](CategoryGroupWithCategories.md) | | |
|
8
|
+
| **server_knowledge** | **Integer** | The knowledge of the server | |
|
9
|
+
|
data/docs/Category.md
ADDED
@@ -0,0 +1,30 @@
|
|
1
|
+
# YNAB::Category
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **id** | **String** | | |
|
8
|
+
| **category_group_id** | **String** | | |
|
9
|
+
| **category_group_name** | **String** | | [optional] |
|
10
|
+
| **name** | **String** | | |
|
11
|
+
| **hidden** | **Boolean** | Whether or not the category is hidden | |
|
12
|
+
| **original_category_group_id** | **String** | DEPRECATED: No longer used. Value will always be null. | [optional] |
|
13
|
+
| **note** | **String** | | [optional] |
|
14
|
+
| **budgeted** | **Integer** | Budgeted amount in milliunits format | |
|
15
|
+
| **activity** | **Integer** | Activity amount in milliunits format | |
|
16
|
+
| **balance** | **Integer** | Balance in milliunits format | |
|
17
|
+
| **goal_type** | **String** | The type of goal, if the category has a goal (TB='Target Category Balance', TBD='Target Category Balance by Date', MF='Monthly Funding', NEED='Plan Your Spending') | [optional] |
|
18
|
+
| **goal_day** | **Integer** | A day offset modifier for the goal's due date. When goal_cadence is 2 (Weekly), this value specifies which day of the week the goal is due (0 = Sunday, 6 = Saturday). Otherwise, this value specifies which day of the month the goal is due (1 = 1st, 31 = 31st, null = Last day of Month). | [optional] |
|
19
|
+
| **goal_cadence** | **Integer** | The goal cadence. Value in range 0-14. There are two subsets of these values which behave differently. For values 0, 1, 2, and 13, the goal's due date repeats every goal_cadence * goal_cadence_frequency, where 0 = None, 1 = Monthly, 2 = Weekly, and 13 = Yearly. For example, goal_cadence 1 with goal_cadence_frequency 2 means the goal is due every other month. For values 3-12 and 14, goal_cadence_frequency is ignored and the goal's due date repeats every goal_cadence, where 3 = Every 2 Months, 4 = Every 3 Months, ..., 12 = Every 11 Months, and 14 = Every 2 Years. | [optional] |
|
20
|
+
| **goal_cadence_frequency** | **Integer** | The goal cadence frequency. When goal_cadence is 0, 1, 2, or 13, a goal's due date repeats every goal_cadence * goal_cadence_frequency. For example, goal_cadence 1 with goal_cadence_frequency 2 means the goal is due every other month. When goal_cadence is 3-12 or 14, goal_cadence_frequency is ignored. | [optional] |
|
21
|
+
| **goal_creation_month** | **Date** | The month a goal was created | [optional] |
|
22
|
+
| **goal_target** | **Integer** | The goal target amount in milliunits | [optional] |
|
23
|
+
| **goal_target_month** | **Date** | The original target month for the goal to be completed. Only some goal types specify this date. | [optional] |
|
24
|
+
| **goal_percentage_complete** | **Integer** | The percentage completion of the goal | [optional] |
|
25
|
+
| **goal_months_to_budget** | **Integer** | The number of months, including the current month, left in the current goal period. | [optional] |
|
26
|
+
| **goal_under_funded** | **Integer** | The amount of funding still needed in the current month to stay on track towards completing the goal within the current goal period. This amount will generally correspond to the 'Underfunded' amount in the web and mobile clients except when viewing a category with a Needed for Spending Goal in a future month. The web and mobile clients will ignore any funding from a prior goal period when viewing category with a Needed for Spending Goal in a future month. | [optional] |
|
27
|
+
| **goal_overall_funded** | **Integer** | The total amount funded towards the goal within the current goal period. | [optional] |
|
28
|
+
| **goal_overall_left** | **Integer** | The amount of funding still needed to complete the goal within the current goal period. | [optional] |
|
29
|
+
| **deleted** | **Boolean** | Whether or not the category has been deleted. Deleted categories will only be included in delta requests. | |
|
30
|
+
|
@@ -0,0 +1,11 @@
|
|
1
|
+
# YNAB::CategoryGroup
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **id** | **String** | | |
|
8
|
+
| **name** | **String** | | |
|
9
|
+
| **hidden** | **Boolean** | Whether or not the category group is hidden | |
|
10
|
+
| **deleted** | **Boolean** | Whether or not the category group has been deleted. Deleted category groups will only be included in delta requests. | |
|
11
|
+
|
@@ -0,0 +1,12 @@
|
|
1
|
+
# YNAB::CategoryGroupWithCategories
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **id** | **String** | | |
|
8
|
+
| **name** | **String** | | |
|
9
|
+
| **hidden** | **Boolean** | Whether or not the category group is hidden | |
|
10
|
+
| **deleted** | **Boolean** | Whether or not the category group has been deleted. Deleted category groups will only be included in delta requests. | |
|
11
|
+
| **categories** | [**Array<Category>**](Category.md) | Category group categories. Amounts (budgeted, activity, balance, etc.) are specific to the current budget month (UTC). | |
|
12
|
+
|
@@ -0,0 +1,8 @@
|
|
1
|
+
# YNAB::CategoryGroupWithCategoriesAllOf
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **categories** | [**Array<Category>**](Category.md) | Category group categories. Amounts (budgeted, activity, balance, etc.) are specific to the current budget month (UTC). | |
|
8
|
+
|
@@ -0,0 +1,9 @@
|
|
1
|
+
# YNAB::CategoryGroupsWrapper
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**category_groups** | [**Array<CategoryGroupWithCategories>**](CategoryGroupWithCategories.md) | |
|
7
|
+
**server_knowledge** | **Integer** | The knowledge of the server |
|
8
|
+
|
9
|
+
|
@@ -0,0 +1,15 @@
|
|
1
|
+
# YNAB::CurrencyFormat
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **iso_code** | **String** | | |
|
8
|
+
| **example_format** | **String** | | |
|
9
|
+
| **decimal_digits** | **Integer** | | |
|
10
|
+
| **decimal_separator** | **String** | | |
|
11
|
+
| **symbol_first** | **Boolean** | | |
|
12
|
+
| **group_separator** | **String** | | |
|
13
|
+
| **currency_symbol** | **String** | | |
|
14
|
+
| **display_symbol** | **Boolean** | | |
|
15
|
+
|
data/docs/DateFormat.md
ADDED
@@ -0,0 +1,28 @@
|
|
1
|
+
# YNAB::DeprecatedApi
|
2
|
+
|
3
|
+
All URIs are relative to *https://api.ynab.com/v1*
|
4
|
+
|
5
|
+
| Method | HTTP request | Description |
|
6
|
+
| ------ | ------------ | ----------- |
|
7
|
+
| [**bulk_create_transactions**](DeprecatedApi.md#bulk_create_transactions) | **POST** /budgets/{budget_id}/transactions/bulk | Bulk create transactions |
|
8
|
+
|
9
|
+
|
10
|
+
## bulk_create_transactions
|
11
|
+
|
12
|
+
> <BulkResponse> bulk_create_transactions(budget_id, transactions)
|
13
|
+
|
14
|
+
Bulk create transactions
|
15
|
+
|
16
|
+
Creates multiple transactions. Although this endpoint is still supported, it is recommended to use 'POST /budgets/{budget_id}/transactions' to create multiple transactions.
|
17
|
+
|
18
|
+
### Parameters
|
19
|
+
|
20
|
+
| Name | Type | Description | Notes |
|
21
|
+
| ---- | ---- | ----------- | ----- |
|
22
|
+
| **budget_id** | **String** | The id of the budget. \"last-used\" can be used to specify the last used budget and \"default\" can be used if default budget selection is enabled (see: https://api.ynab.com/#oauth-default-budget). | |
|
23
|
+
| **transactions** | [**BulkTransactions**](BulkTransactions.md) | The list of transactions to create | |
|
24
|
+
|
25
|
+
### Return type
|
26
|
+
|
27
|
+
[**BulkResponse**](BulkResponse.md)
|
28
|
+
|
data/docs/ErrorDetail.md
ADDED
@@ -0,0 +1,30 @@
|
|
1
|
+
# YNAB::HybridTransaction
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **id** | **String** | | |
|
8
|
+
| **date** | **Date** | The transaction date in ISO format (e.g. 2016-12-01) | |
|
9
|
+
| **amount** | **Integer** | The transaction amount in milliunits format | |
|
10
|
+
| **memo** | **String** | | [optional] |
|
11
|
+
| **cleared** | **String** | The cleared status of the transaction | |
|
12
|
+
| **approved** | **Boolean** | Whether or not the transaction is approved | |
|
13
|
+
| **flag_color** | **String** | The transaction flag | [optional] |
|
14
|
+
| **account_id** | **String** | | |
|
15
|
+
| **payee_id** | **String** | | [optional] |
|
16
|
+
| **category_id** | **String** | | [optional] |
|
17
|
+
| **transfer_account_id** | **String** | If a transfer transaction, the account to which it transfers | [optional] |
|
18
|
+
| **transfer_transaction_id** | **String** | If a transfer transaction, the id of transaction on the other side of the transfer | [optional] |
|
19
|
+
| **matched_transaction_id** | **String** | If transaction is matched, the id of the matched transaction | [optional] |
|
20
|
+
| **import_id** | **String** | If the transaction was imported, this field is a unique (by account) import identifier. If this transaction was imported through File Based Import or Direct Import and not through the API, the import_id will have the format: 'YNAB:[milliunit_amount]:[iso_date]:[occurrence]'. For example, a transaction dated 2015-12-30 in the amount of -$294.23 USD would have an import_id of 'YNAB:-294230:2015-12-30:1'. If a second transaction on the same account was imported and had the same date and same amount, its import_id would be 'YNAB:-294230:2015-12-30:2'. | [optional] |
|
21
|
+
| **import_payee_name** | **String** | If the transaction was imported, the payee name that was used when importing and before applying any payee rename rules | [optional] |
|
22
|
+
| **import_payee_name_original** | **String** | If the transaction was imported, the original payee name as it appeared on the statement | [optional] |
|
23
|
+
| **debt_transaction_type** | **String** | If the transaction is a debt/loan account transaction, the type of transaction | [optional] |
|
24
|
+
| **deleted** | **Boolean** | Whether or not the transaction has been deleted. Deleted transactions will only be included in delta requests. | |
|
25
|
+
| **type** | **String** | Whether the hybrid transaction represents a regular transaction or a subtransaction | |
|
26
|
+
| **parent_transaction_id** | **String** | For subtransaction types, this is the id of the parent transaction. For transaction types, this id will be always be null. | [optional] |
|
27
|
+
| **account_name** | **String** | | |
|
28
|
+
| **payee_name** | **String** | | [optional] |
|
29
|
+
| **category_name** | **String** | The name of the category. If a split transaction, this will be 'Split'. | [optional] |
|
30
|
+
|
@@ -0,0 +1,12 @@
|
|
1
|
+
# YNAB::HybridTransactionAllOf
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **type** | **String** | Whether the hybrid transaction represents a regular transaction or a subtransaction | |
|
8
|
+
| **parent_transaction_id** | **String** | For subtransaction types, this is the id of the parent transaction. For transaction types, this id will be always be null. | [optional] |
|
9
|
+
| **account_name** | **String** | | |
|
10
|
+
| **payee_name** | **String** | | [optional] |
|
11
|
+
| **category_name** | **String** | The name of the category. If a split transaction, this will be 'Split'. | [optional] |
|
12
|
+
|
@@ -0,0 +1,9 @@
|
|
1
|
+
# YNAB::HybridTransactionsResponseData
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **transactions** | [**Array<HybridTransaction>**](HybridTransaction.md) | | |
|
8
|
+
| **server_knowledge** | **Integer** | The knowledge of the server | [optional] |
|
9
|
+
|
data/docs/MonthDetail.md
ADDED
@@ -0,0 +1,16 @@
|
|
1
|
+
# YNAB::MonthDetail
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **month** | **Date** | | |
|
8
|
+
| **note** | **String** | | [optional] |
|
9
|
+
| **income** | **Integer** | The total amount of transactions categorized to 'Inflow: Ready to Assign' in the month | |
|
10
|
+
| **budgeted** | **Integer** | The total amount budgeted in the month | |
|
11
|
+
| **activity** | **Integer** | The total amount of transactions in the month, excluding those categorized to 'Inflow: Ready to Assign' | |
|
12
|
+
| **to_be_budgeted** | **Integer** | The available amount for 'Ready to Assign' | |
|
13
|
+
| **age_of_money** | **Integer** | The Age of Money as of the month | [optional] |
|
14
|
+
| **deleted** | **Boolean** | Whether or not the month has been deleted. Deleted months will only be included in delta requests. | |
|
15
|
+
| **categories** | [**Array<Category>**](Category.md) | The budget month categories. Amounts (budgeted, activity, balance, etc.) are specific to the {month} parameter specified. | |
|
16
|
+
|
@@ -0,0 +1,8 @@
|
|
1
|
+
# YNAB::MonthDetailAllOf
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **categories** | [**Array<Category>**](Category.md) | The budget month categories. Amounts (budgeted, activity, balance, etc.) are specific to the {month} parameter specified. | |
|
8
|
+
|
@@ -0,0 +1,9 @@
|
|
1
|
+
# YNAB::MonthSummariesResponseData
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **months** | [**Array<MonthSummary>**](MonthSummary.md) | | |
|
8
|
+
| **server_knowledge** | **Integer** | The knowledge of the server | |
|
9
|
+
|
@@ -0,0 +1,9 @@
|
|
1
|
+
# YNAB::MonthSummariesWrapper
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**months** | [**Array<MonthSummary>**](MonthSummary.md) | |
|
7
|
+
**server_knowledge** | **Integer** | The knowledge of the server |
|
8
|
+
|
9
|
+
|
@@ -0,0 +1,15 @@
|
|
1
|
+
# YNAB::MonthSummary
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **month** | **Date** | | |
|
8
|
+
| **note** | **String** | | [optional] |
|
9
|
+
| **income** | **Integer** | The total amount of transactions categorized to 'Inflow: Ready to Assign' in the month | |
|
10
|
+
| **budgeted** | **Integer** | The total amount budgeted in the month | |
|
11
|
+
| **activity** | **Integer** | The total amount of transactions in the month, excluding those categorized to 'Inflow: Ready to Assign' | |
|
12
|
+
| **to_be_budgeted** | **Integer** | The available amount for 'Ready to Assign' | |
|
13
|
+
| **age_of_money** | **Integer** | The Age of Money as of the month | [optional] |
|
14
|
+
| **deleted** | **Boolean** | Whether or not the month has been deleted. Deleted months will only be included in delta requests. | |
|
15
|
+
|
data/docs/MonthsApi.md
ADDED
@@ -0,0 +1,49 @@
|
|
1
|
+
# YNAB::MonthsApi
|
2
|
+
|
3
|
+
All URIs are relative to *https://api.ynab.com/v1*
|
4
|
+
|
5
|
+
| Method | HTTP request | Description |
|
6
|
+
| ------ | ------------ | ----------- |
|
7
|
+
| [**get_budget_month**](MonthsApi.md#get_budget_month) | **GET** /budgets/{budget_id}/months/{month} | Single budget month |
|
8
|
+
| [**get_budget_months**](MonthsApi.md#get_budget_months) | **GET** /budgets/{budget_id}/months | List budget months |
|
9
|
+
|
10
|
+
|
11
|
+
## get_budget_month
|
12
|
+
|
13
|
+
> <MonthDetailResponse> get_budget_month(budget_id, month)
|
14
|
+
|
15
|
+
Single budget month
|
16
|
+
|
17
|
+
Returns a single budget month
|
18
|
+
|
19
|
+
### Parameters
|
20
|
+
|
21
|
+
| Name | Type | Description | Notes |
|
22
|
+
| ---- | ---- | ----------- | ----- |
|
23
|
+
| **budget_id** | **String** | The id of the budget. \"last-used\" can be used to specify the last used budget and \"default\" can be used if default budget selection is enabled (see: https://api.ynab.com/#oauth-default-budget). | |
|
24
|
+
| **month** | **Date** | The budget month in ISO format (e.g. 2016-12-01) (\"current\" can also be used to specify the current calendar month (UTC)) | |
|
25
|
+
|
26
|
+
### Return type
|
27
|
+
|
28
|
+
[**MonthDetailResponse**](MonthDetailResponse.md)
|
29
|
+
|
30
|
+
|
31
|
+
## get_budget_months
|
32
|
+
|
33
|
+
> <MonthSummariesResponse> get_budget_months(budget_id, opts)
|
34
|
+
|
35
|
+
List budget months
|
36
|
+
|
37
|
+
Returns all budget months
|
38
|
+
|
39
|
+
### Parameters
|
40
|
+
|
41
|
+
| Name | Type | Description | Notes |
|
42
|
+
| ---- | ---- | ----------- | ----- |
|
43
|
+
| **budget_id** | **String** | The id of the budget. \"last-used\" can be used to specify the last used budget and \"default\" can be used if default budget selection is enabled (see: https://api.ynab.com/#oauth-default-budget). | |
|
44
|
+
| **last_knowledge_of_server** | **Integer** | The starting server knowledge. If provided, only entities that have changed since `last_knowledge_of_server` will be included. | [optional] |
|
45
|
+
|
46
|
+
### Return type
|
47
|
+
|
48
|
+
[**MonthSummariesResponse**](MonthSummariesResponse.md)
|
49
|
+
|
data/docs/Payee.md
ADDED
@@ -0,0 +1,11 @@
|
|
1
|
+
# YNAB::Payee
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **id** | **String** | | |
|
8
|
+
| **name** | **String** | | |
|
9
|
+
| **transfer_account_id** | **String** | If a transfer payee, the `account_id` to which this payee transfers to | [optional] |
|
10
|
+
| **deleted** | **Boolean** | Whether or not the payee has been deleted. Deleted payees will only be included in delta requests. | |
|
11
|
+
|
@@ -0,0 +1,12 @@
|
|
1
|
+
# YNAB::PayeeLocation
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **id** | **String** | | |
|
8
|
+
| **payee_id** | **String** | | |
|
9
|
+
| **latitude** | **String** | | |
|
10
|
+
| **longitude** | **String** | | |
|
11
|
+
| **deleted** | **Boolean** | Whether or not the payee location has been deleted. Deleted payee locations will only be included in delta requests. | |
|
12
|
+
|