ynab 1.31.0 → 2.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (260) hide show
  1. checksums.yaml +4 -4
  2. data/DEVELOPMENT.md +11 -0
  3. data/Gemfile +8 -0
  4. data/Gemfile.lock +42 -0
  5. data/README.md +3 -3
  6. data/Rakefile +58 -0
  7. data/config.json +9 -0
  8. data/docs/Account.md +25 -0
  9. data/docs/AccountResponse.md +8 -0
  10. data/docs/AccountResponseData.md +8 -0
  11. data/docs/AccountType.md +7 -0
  12. data/docs/AccountWrapper.md +8 -0
  13. data/docs/AccountsApi.md +70 -0
  14. data/docs/AccountsResponse.md +8 -0
  15. data/docs/AccountsResponseData.md +9 -0
  16. data/docs/AccountsWrapper.md +9 -0
  17. data/docs/BudgetDetail.md +24 -0
  18. data/docs/BudgetDetailAllOf.md +17 -0
  19. data/docs/BudgetDetailResponse.md +8 -0
  20. data/docs/BudgetDetailResponseData.md +9 -0
  21. data/docs/BudgetDetailWrapper.md +9 -0
  22. data/docs/BudgetSettings.md +9 -0
  23. data/docs/BudgetSettingsResponse.md +8 -0
  24. data/docs/BudgetSettingsResponseData.md +8 -0
  25. data/docs/BudgetSettingsWrapper.md +8 -0
  26. data/docs/BudgetSummary.md +15 -0
  27. data/docs/BudgetSummaryResponse.md +8 -0
  28. data/docs/BudgetSummaryResponseData.md +9 -0
  29. data/docs/BudgetSummaryWrapper.md +9 -0
  30. data/docs/BudgetsApi.md +68 -0
  31. data/docs/BulkIdWrapper.md +8 -0
  32. data/docs/BulkIds.md +9 -0
  33. data/docs/BulkResponse.md +8 -0
  34. data/docs/BulkResponseData.md +8 -0
  35. data/docs/BulkResponseDataBulk.md +9 -0
  36. data/docs/BulkTransactionCreateResponse.md +8 -0
  37. data/docs/BulkTransactionIds.md +8 -0
  38. data/docs/BulkTransactions.md +8 -0
  39. data/docs/CategoriesApi.md +94 -0
  40. data/docs/CategoriesResponse.md +8 -0
  41. data/docs/CategoriesResponseData.md +9 -0
  42. data/docs/Category.md +30 -0
  43. data/docs/CategoryGroup.md +11 -0
  44. data/docs/CategoryGroupWithCategories.md +12 -0
  45. data/docs/CategoryGroupWithCategoriesAllOf.md +8 -0
  46. data/docs/CategoryGroupsWrapper.md +9 -0
  47. data/docs/CategoryResponse.md +8 -0
  48. data/docs/CategoryResponseData.md +8 -0
  49. data/docs/CategoryWrapper.md +9 -0
  50. data/docs/CurrencyFormat.md +15 -0
  51. data/docs/DateFormat.md +8 -0
  52. data/docs/DeprecatedApi.md +28 -0
  53. data/docs/ErrorDetail.md +10 -0
  54. data/docs/ErrorResponse.md +8 -0
  55. data/docs/HybridTransaction.md +30 -0
  56. data/docs/HybridTransactionAllOf.md +12 -0
  57. data/docs/HybridTransactionsResponse.md +8 -0
  58. data/docs/HybridTransactionsResponseData.md +9 -0
  59. data/docs/HybridTransactionsWrapper.md +8 -0
  60. data/docs/LoanAccountPeriodicValue.md +7 -0
  61. data/docs/MonthDetail.md +16 -0
  62. data/docs/MonthDetailAllOf.md +8 -0
  63. data/docs/MonthDetailResponse.md +8 -0
  64. data/docs/MonthDetailResponseData.md +8 -0
  65. data/docs/MonthDetailWrapper.md +8 -0
  66. data/docs/MonthSummariesResponse.md +8 -0
  67. data/docs/MonthSummariesResponseData.md +9 -0
  68. data/docs/MonthSummariesWrapper.md +9 -0
  69. data/docs/MonthSummary.md +15 -0
  70. data/docs/MonthsApi.md +49 -0
  71. data/docs/PatchMonthCategoryWrapper.md +8 -0
  72. data/docs/PatchTransactionsWrapper.md +8 -0
  73. data/docs/Payee.md +11 -0
  74. data/docs/PayeeLocation.md +12 -0
  75. data/docs/PayeeLocationResponse.md +8 -0
  76. data/docs/PayeeLocationResponseData.md +8 -0
  77. data/docs/PayeeLocationWrapper.md +8 -0
  78. data/docs/PayeeLocationsApi.md +69 -0
  79. data/docs/PayeeLocationsResponse.md +8 -0
  80. data/docs/PayeeLocationsResponseData.md +8 -0
  81. data/docs/PayeeLocationsWrapper.md +8 -0
  82. data/docs/PayeeResponse.md +8 -0
  83. data/docs/PayeeResponseData.md +8 -0
  84. data/docs/PayeeWrapper.md +8 -0
  85. data/docs/PayeesApi.md +49 -0
  86. data/docs/PayeesResponse.md +8 -0
  87. data/docs/PayeesResponseData.md +9 -0
  88. data/docs/PayeesWrapper.md +9 -0
  89. data/docs/PostAccountWrapper.md +8 -0
  90. data/docs/PostTransactionsWrapper.md +9 -0
  91. data/docs/PutTransactionWrapper.md +8 -0
  92. data/docs/SaveAccount.md +10 -0
  93. data/docs/SaveAccountWrapper.md +8 -0
  94. data/docs/SaveCategoryResponse.md +8 -0
  95. data/docs/SaveCategoryResponseData.md +9 -0
  96. data/docs/SaveMonthCategory.md +8 -0
  97. data/docs/SaveMonthCategoryWrapper.md +8 -0
  98. data/docs/SaveSubTransaction.md +12 -0
  99. data/docs/SaveTransaction.md +19 -0
  100. data/docs/SaveTransactionWithId.md +20 -0
  101. data/docs/SaveTransactionWithIdAllOf.md +8 -0
  102. data/docs/SaveTransactionWithOptionalFields.md +19 -0
  103. data/docs/SaveTransactionWrapper.md +8 -0
  104. data/docs/SaveTransactionsResponse.md +8 -0
  105. data/docs/SaveTransactionsResponseData.md +12 -0
  106. data/docs/SaveTransactionsWrapper.md +9 -0
  107. data/docs/ScheduledSubTransaction.md +15 -0
  108. data/docs/ScheduledTransactionDetail.md +23 -0
  109. data/docs/ScheduledTransactionDetailAllOf.md +11 -0
  110. data/docs/ScheduledTransactionResponse.md +8 -0
  111. data/docs/ScheduledTransactionResponseData.md +8 -0
  112. data/docs/ScheduledTransactionSummary.md +19 -0
  113. data/docs/ScheduledTransactionWrapper.md +8 -0
  114. data/docs/ScheduledTransactionsApi.md +49 -0
  115. data/docs/ScheduledTransactionsResponse.md +8 -0
  116. data/docs/ScheduledTransactionsResponseData.md +9 -0
  117. data/docs/ScheduledTransactionsWrapper.md +8 -0
  118. data/docs/SubTransaction.md +18 -0
  119. data/docs/TransactionDetail.md +29 -0
  120. data/docs/TransactionDetailAllOf.md +11 -0
  121. data/docs/TransactionResponse.md +8 -0
  122. data/docs/TransactionResponseData.md +8 -0
  123. data/docs/TransactionSummary.md +25 -0
  124. data/docs/TransactionWrapper.md +8 -0
  125. data/docs/TransactionsApi.md +228 -0
  126. data/docs/TransactionsImportResponse.md +8 -0
  127. data/docs/TransactionsImportResponseData.md +8 -0
  128. data/docs/TransactionsResponse.md +8 -0
  129. data/docs/TransactionsResponseData.md +9 -0
  130. data/docs/TransactionsWrapper.md +9 -0
  131. data/docs/UpdateTransaction.md +20 -0
  132. data/docs/UpdateTransactionsWrapper.md +8 -0
  133. data/docs/User.md +8 -0
  134. data/docs/UserApi.md +25 -0
  135. data/docs/UserResponse.md +8 -0
  136. data/docs/UserResponseData.md +8 -0
  137. data/docs/UserWrapper.md +8 -0
  138. data/examples/budget-list.rb +21 -0
  139. data/examples/budget-month.rb +33 -0
  140. data/examples/category-balance.rb +23 -0
  141. data/examples/create-multiple-transactions.rb +42 -0
  142. data/examples/create-transaction.rb +30 -0
  143. data/examples/update-category-budgeted.rb +25 -0
  144. data/examples/update-multiple-transactions.rb +20 -0
  145. data/lib/ynab/api/accounts_api.rb +78 -41
  146. data/lib/ynab/api/budgets_api.rb +68 -36
  147. data/lib/ynab/api/categories_api.rb +108 -60
  148. data/lib/ynab/api/deprecated_api.rb +32 -17
  149. data/lib/ynab/api/months_api.rb +49 -28
  150. data/lib/ynab/api/payee_locations_api.rb +73 -41
  151. data/lib/ynab/api/payees_api.rb +49 -28
  152. data/lib/ynab/api/scheduled_transactions_api.rb +49 -28
  153. data/lib/ynab/api/transactions_api.rb +268 -140
  154. data/lib/ynab/api/user_api.rb +22 -12
  155. data/lib/ynab/api_client.rb +97 -95
  156. data/lib/ynab/configuration.rb +101 -14
  157. data/lib/ynab/models/account.rb +117 -55
  158. data/lib/ynab/models/account_response.rb +53 -18
  159. data/lib/ynab/models/account_response_data.rb +53 -18
  160. data/lib/ynab/models/account_type.rb +30 -20
  161. data/lib/ynab/models/accounts_response.rb +53 -18
  162. data/lib/ynab/models/accounts_response_data.rb +54 -19
  163. data/lib/ynab/models/budget_detail.rb +80 -35
  164. data/lib/ynab/models/budget_detail_all_of.rb +320 -0
  165. data/lib/ynab/models/budget_detail_response.rb +53 -18
  166. data/lib/ynab/models/budget_detail_response_data.rb +54 -19
  167. data/lib/ynab/models/budget_settings.rb +56 -29
  168. data/lib/ynab/models/budget_settings_response.rb +53 -18
  169. data/lib/ynab/models/budget_settings_response_data.rb +53 -18
  170. data/lib/ynab/models/budget_summary.rb +63 -26
  171. data/lib/ynab/models/budget_summary_response.rb +53 -18
  172. data/lib/ynab/models/budget_summary_response_data.rb +54 -20
  173. data/lib/ynab/models/bulk_response.rb +53 -18
  174. data/lib/ynab/models/bulk_response_data.rb +53 -18
  175. data/lib/ynab/models/bulk_response_data_bulk.rb +54 -19
  176. data/lib/ynab/models/bulk_transactions.rb +53 -18
  177. data/lib/ynab/models/categories_response.rb +53 -18
  178. data/lib/ynab/models/categories_response_data.rb +54 -19
  179. data/lib/ynab/models/category.rb +110 -48
  180. data/lib/ynab/models/category_group.rb +58 -23
  181. data/lib/ynab/models/category_group_with_categories.rb +67 -24
  182. data/lib/ynab/models/{save_month_category_wrapper.rb → category_group_with_categories_all_of.rb} +67 -29
  183. data/lib/ynab/models/category_response.rb +53 -18
  184. data/lib/ynab/models/category_response_data.rb +53 -18
  185. data/lib/ynab/models/currency_format.rb +62 -27
  186. data/lib/ynab/models/date_format.rb +53 -18
  187. data/lib/ynab/models/error_detail.rb +55 -20
  188. data/lib/ynab/models/error_response.rb +53 -18
  189. data/lib/ynab/models/hybrid_transaction.rb +118 -46
  190. data/lib/ynab/models/hybrid_transaction_all_of.rb +304 -0
  191. data/lib/ynab/models/hybrid_transactions_response.rb +53 -18
  192. data/lib/ynab/models/hybrid_transactions_response_data.rb +54 -19
  193. data/lib/ynab/models/month_detail.rb +72 -27
  194. data/lib/ynab/models/{update_transactions_wrapper.rb → month_detail_all_of.rb} +66 -30
  195. data/lib/ynab/models/month_detail_response.rb +53 -18
  196. data/lib/ynab/models/month_detail_response_data.rb +53 -18
  197. data/lib/ynab/models/month_summaries_response.rb +53 -18
  198. data/lib/ynab/models/month_summaries_response_data.rb +54 -19
  199. data/lib/ynab/models/month_summary.rb +63 -26
  200. data/lib/ynab/models/patch_month_category_wrapper.rb +53 -18
  201. data/lib/ynab/models/patch_transactions_wrapper.rb +53 -18
  202. data/lib/ynab/models/payee.rb +58 -22
  203. data/lib/ynab/models/payee_location.rb +58 -23
  204. data/lib/ynab/models/payee_location_response.rb +53 -18
  205. data/lib/ynab/models/payee_location_response_data.rb +53 -18
  206. data/lib/ynab/models/payee_locations_response.rb +53 -18
  207. data/lib/ynab/models/payee_locations_response_data.rb +53 -18
  208. data/lib/ynab/models/payee_response.rb +53 -18
  209. data/lib/ynab/models/payee_response_data.rb +53 -18
  210. data/lib/ynab/models/payees_response.rb +53 -18
  211. data/lib/ynab/models/payees_response_data.rb +54 -19
  212. data/lib/ynab/models/post_account_wrapper.rb +53 -18
  213. data/lib/ynab/models/post_transactions_wrapper.rb +54 -19
  214. data/lib/ynab/models/put_transaction_wrapper.rb +53 -18
  215. data/lib/ynab/models/save_account.rb +77 -20
  216. data/lib/ynab/models/save_category_response.rb +53 -18
  217. data/lib/ynab/models/save_category_response_data.rb +54 -19
  218. data/lib/ynab/models/save_month_category.rb +53 -18
  219. data/lib/ynab/models/save_sub_transaction.rb +61 -22
  220. data/lib/ynab/models/save_transaction.rb +88 -33
  221. data/lib/ynab/models/save_transaction_with_id.rb +102 -46
  222. data/lib/ynab/models/{save_transactions_wrapper.rb → save_transaction_with_id_all_of.rb} +60 -36
  223. data/lib/ynab/models/save_transaction_with_optional_fields.rb +81 -33
  224. data/lib/ynab/models/save_transactions_response.rb +53 -18
  225. data/lib/ynab/models/save_transactions_response_data.rb +57 -23
  226. data/lib/ynab/models/scheduled_sub_transaction.rb +66 -27
  227. data/lib/ynab/models/scheduled_transaction_detail.rb +94 -36
  228. data/lib/ynab/models/scheduled_transaction_detail_all_of.rb +262 -0
  229. data/lib/ynab/models/scheduled_transaction_response.rb +53 -18
  230. data/lib/ynab/models/scheduled_transaction_response_data.rb +53 -18
  231. data/lib/ynab/models/scheduled_transaction_summary.rb +80 -32
  232. data/lib/ynab/models/scheduled_transactions_response.rb +53 -18
  233. data/lib/ynab/models/scheduled_transactions_response_data.rb +54 -19
  234. data/lib/ynab/models/sub_transaction.rb +71 -29
  235. data/lib/ynab/models/transaction_detail.rb +112 -44
  236. data/lib/ynab/models/{save_transaction_wrapper.rb → transaction_detail_all_of.rb} +102 -29
  237. data/lib/ynab/models/transaction_response.rb +53 -18
  238. data/lib/ynab/models/transaction_response_data.rb +53 -18
  239. data/lib/ynab/models/transaction_summary.rb +98 -40
  240. data/lib/ynab/models/transactions_import_response.rb +53 -18
  241. data/lib/ynab/models/transactions_import_response_data.rb +53 -18
  242. data/lib/ynab/models/transactions_response.rb +53 -18
  243. data/lib/ynab/models/transactions_response_data.rb +54 -19
  244. data/lib/ynab/models/user.rb +53 -18
  245. data/lib/ynab/models/user_response.rb +53 -18
  246. data/lib/ynab/models/user_response_data.rb +53 -18
  247. data/lib/ynab/version.rb +1 -1
  248. data/lib/ynab.rb +19 -14
  249. data/open_api_spec.yaml +3012 -0
  250. data/templates/api_client.mustache +274 -0
  251. data/templates/api_client_typhoeus_partial.mustache +156 -0
  252. data/templates/api_doc.mustache +44 -0
  253. data/templates/gem.mustache +84 -0
  254. data/templates/partial_model_generic_doc.mustache +9 -0
  255. data/ynab.gemspec +38 -0
  256. metadata +192 -85
  257. data/lib/ynab/models/loan_account_periodic_value.rb +0 -175
  258. data/lib/ynab/models/save_account_wrapper.rb +0 -189
  259. data/lib/ynab/models/update_transaction.rb +0 -407
  260. 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. \&quot;last-used\&quot; can be used to specify the last used budget and \&quot;default\&quot; 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 &#x60;last_knowledge_of_server&#x60; 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. \&quot;last-used\&quot; can be used to specify the last used budget and \&quot;default\&quot; 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. \&quot;last-used\&quot; can be used to specify the last used budget and \&quot;default\&quot; 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) (\&quot;current\&quot; 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. \&quot;last-used\&quot; can be used to specify the last used budget and \&quot;default\&quot; 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) (\&quot;current\&quot; 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 &#x60;budgeted&#x60; 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,8 @@
1
+ # YNAB::CategoriesResponse
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **data** | [**CategoriesResponseData**](CategoriesResponseData.md) | | |
8
+
@@ -0,0 +1,9 @@
1
+ # YNAB::CategoriesResponseData
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **category_groups** | [**Array&lt;CategoryGroupWithCategories&gt;**](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&#x3D;&#39;Target Category Balance&#39;, TBD&#x3D;&#39;Target Category Balance by Date&#39;, MF&#x3D;&#39;Monthly Funding&#39;, NEED&#x3D;&#39;Plan Your Spending&#39;) | [optional] |
18
+ | **goal_day** | **Integer** | A day offset modifier for the goal&#39;s due date. When goal_cadence is 2 (Weekly), this value specifies which day of the week the goal is due (0 &#x3D; Sunday, 6 &#x3D; Saturday). Otherwise, this value specifies which day of the month the goal is due (1 &#x3D; 1st, 31 &#x3D; 31st, null &#x3D; 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&#39;s due date repeats every goal_cadence * goal_cadence_frequency, where 0 &#x3D; None, 1 &#x3D; Monthly, 2 &#x3D; Weekly, and 13 &#x3D; 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&#39;s due date repeats every goal_cadence, where 3 &#x3D; Every 2 Months, 4 &#x3D; Every 3 Months, ..., 12 &#x3D; Every 11 Months, and 14 &#x3D; Every 2 Years. | [optional] |
20
+ | **goal_cadence_frequency** | **Integer** | The goal cadence frequency. When goal_cadence is 0, 1, 2, or 13, a goal&#39;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 &#39;Underfunded&#39; 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&lt;Category&gt;**](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&lt;Category&gt;**](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&lt;CategoryGroupWithCategories&gt;**](CategoryGroupWithCategories.md) | |
7
+ **server_knowledge** | **Integer** | The knowledge of the server |
8
+
9
+
@@ -0,0 +1,8 @@
1
+ # YNAB::CategoryResponse
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **data** | [**CategoryResponseData**](CategoryResponseData.md) | | |
8
+
@@ -0,0 +1,8 @@
1
+ # YNAB::CategoryResponseData
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **category** | [**Category**](Category.md) | | |
8
+
@@ -0,0 +1,9 @@
1
+ # YNAB::CategoryWrapper
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **category** | [**Category**](Category.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
+
@@ -0,0 +1,8 @@
1
+ # YNAB::DateFormat
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **format** | **String** | | |
8
+
@@ -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. \&quot;last-used\&quot; can be used to specify the last used budget and \&quot;default\&quot; 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
+
@@ -0,0 +1,10 @@
1
+ # YNAB::ErrorDetail
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **id** | **String** | | |
8
+ | **name** | **String** | | |
9
+ | **detail** | **String** | | |
10
+
@@ -0,0 +1,8 @@
1
+ # YNAB::ErrorResponse
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **error** | [**ErrorDetail**](ErrorDetail.md) | | |
8
+
@@ -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: &#39;YNAB:[milliunit_amount]:[iso_date]:[occurrence]&#39;. For example, a transaction dated 2015-12-30 in the amount of -$294.23 USD would have an import_id of &#39;YNAB:-294230:2015-12-30:1&#39;. If a second transaction on the same account was imported and had the same date and same amount, its import_id would be &#39;YNAB:-294230:2015-12-30:2&#39;. | [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 &#39;Split&#39;. | [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 &#39;Split&#39;. | [optional] |
12
+
@@ -0,0 +1,8 @@
1
+ # YNAB::HybridTransactionsResponse
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **data** | [**HybridTransactionsResponseData**](HybridTransactionsResponseData.md) | | |
8
+
@@ -0,0 +1,9 @@
1
+ # YNAB::HybridTransactionsResponseData
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **transactions** | [**Array&lt;HybridTransaction&gt;**](HybridTransaction.md) | | |
8
+ | **server_knowledge** | **Integer** | The knowledge of the server | [optional] |
9
+
@@ -0,0 +1,8 @@
1
+ # YNAB::HybridTransactionsWrapper
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **transactions** | [**Array&lt;HybridTransaction&gt;**](HybridTransaction.md) | |
7
+
8
+
@@ -0,0 +1,7 @@
1
+ # YNAB::LoanAccountPeriodicValue
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+
7
+
@@ -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 &#39;Inflow: Ready to Assign&#39; 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 &#39;Inflow: Ready to Assign&#39; | |
12
+ | **to_be_budgeted** | **Integer** | The available amount for &#39;Ready to Assign&#39; | |
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&lt;Category&gt;**](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&lt;Category&gt;**](Category.md) | The budget month categories. Amounts (budgeted, activity, balance, etc.) are specific to the {month} parameter specified. | |
8
+
@@ -0,0 +1,8 @@
1
+ # YNAB::MonthDetailResponse
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **data** | [**MonthDetailResponseData**](MonthDetailResponseData.md) | | |
8
+
@@ -0,0 +1,8 @@
1
+ # YNAB::MonthDetailResponseData
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **month** | [**MonthDetail**](MonthDetail.md) | | |
8
+
@@ -0,0 +1,8 @@
1
+ # YNAB::MonthDetailWrapper
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **month** | [**MonthDetail**](MonthDetail.md) | |
7
+
8
+
@@ -0,0 +1,8 @@
1
+ # YNAB::MonthSummariesResponse
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **data** | [**MonthSummariesResponseData**](MonthSummariesResponseData.md) | | |
8
+
@@ -0,0 +1,9 @@
1
+ # YNAB::MonthSummariesResponseData
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **months** | [**Array&lt;MonthSummary&gt;**](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&lt;MonthSummary&gt;**](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 &#39;Inflow: Ready to Assign&#39; 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 &#39;Inflow: Ready to Assign&#39; | |
12
+ | **to_be_budgeted** | **Integer** | The available amount for &#39;Ready to Assign&#39; | |
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. \&quot;last-used\&quot; can be used to specify the last used budget and \&quot;default\&quot; 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) (\&quot;current\&quot; 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. \&quot;last-used\&quot; can be used to specify the last used budget and \&quot;default\&quot; 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 &#x60;last_knowledge_of_server&#x60; will be included. | [optional] |
45
+
46
+ ### Return type
47
+
48
+ [**MonthSummariesResponse**](MonthSummariesResponse.md)
49
+
@@ -0,0 +1,8 @@
1
+ # YNAB::PatchMonthCategoryWrapper
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **category** | [**SaveMonthCategory**](SaveMonthCategory.md) | | |
8
+
@@ -0,0 +1,8 @@
1
+ # YNAB::PatchTransactionsWrapper
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **transactions** | [**Array&lt;SaveTransactionWithId&gt;**](SaveTransactionWithId.md) | | |
8
+
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 &#x60;account_id&#x60; 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
+
@@ -0,0 +1,8 @@
1
+ # YNAB::PayeeLocationResponse
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **data** | [**PayeeLocationResponseData**](PayeeLocationResponseData.md) | | |
8
+
@@ -0,0 +1,8 @@
1
+ # YNAB::PayeeLocationResponseData
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **payee_location** | [**PayeeLocation**](PayeeLocation.md) | | |
8
+
@@ -0,0 +1,8 @@
1
+ # YNAB::PayeeLocationWrapper
2
+
3
+ ## Properties
4
+ Name | Type | Description | Notes
5
+ ------------ | ------------- | ------------- | -------------
6
+ **payee_location** | [**PayeeLocation**](PayeeLocation.md) | |
7
+
8
+