{ "openapi": "3.0.4", "info": { "title": "Manilo API", "description": "API for Manilo mobile application", "contact": { "name": "Manilo Development Team" }, "version": "v1" }, "paths": { "/api/v1/accounts": { "get": { "tags": [ "Accounts" ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/AccountListResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/AccountListResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/AccountListResponse" } } } } } }, "post": { "tags": [ "Accounts" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateAccountRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CreateAccountRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/CreateAccountRequest" } } } }, "responses": { "201": { "description": "Created", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/AccountDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/AccountDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/AccountDto" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/accounts/{id}": { "get": { "tags": [ "Accounts" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/AccountDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/AccountDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/AccountDto" } } } }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "put": { "tags": [ "Accounts" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateAccountRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/UpdateAccountRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/UpdateAccountRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/AccountDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/AccountDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/AccountDto" } } } }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "delete": { "tags": [ "Accounts" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "action", "in": "query", "schema": { "$ref": "#/components/schemas/AccountDeletionAction" } }, { "name": "move_target_account_id", "in": "query", "schema": { "type": "string" } } ], "responses": { "204": { "description": "No Content" }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/budgets": { "get": { "tags": [ "Budgets" ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/BudgetListResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/BudgetListResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/BudgetListResponse" } } } } } }, "post": { "tags": [ "Budgets" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateBudgetRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CreateBudgetRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/CreateBudgetRequest" } } } }, "responses": { "201": { "description": "Created", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/BudgetDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/BudgetDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/BudgetDto" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/budgets/{id}": { "get": { "tags": [ "Budgets" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/BudgetDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/BudgetDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/BudgetDto" } } } }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "put": { "tags": [ "Budgets" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateBudgetRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/UpdateBudgetRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/UpdateBudgetRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/BudgetDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/BudgetDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/BudgetDto" } } } }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "delete": { "tags": [ "Budgets" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "No Content" }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/categories/system-categories": { "get": { "tags": [ "Categories" ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/WellKnownCategoriesResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/WellKnownCategoriesResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/WellKnownCategoriesResponse" } } } } } } }, "/api/v1/categories/groups": { "get": { "tags": [ "Categories" ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/CategoryGroupListResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CategoryGroupListResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CategoryGroupListResponse" } } } } } }, "post": { "tags": [ "Categories" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCategoryGroupRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CreateCategoryGroupRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/CreateCategoryGroupRequest" } } } }, "responses": { "201": { "description": "Created", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/CategoryGroupDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CategoryGroupDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CategoryGroupDto" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/categories/groups/{id}": { "get": { "tags": [ "Categories" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/CategoryGroupDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CategoryGroupDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CategoryGroupDto" } } } }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "put": { "tags": [ "Categories" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateCategoryGroupRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/UpdateCategoryGroupRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/UpdateCategoryGroupRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/CategoryGroupDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CategoryGroupDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CategoryGroupDto" } } } }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "delete": { "tags": [ "Categories" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "No Content" }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/categories": { "get": { "tags": [ "Categories" ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/CategoryListResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CategoryListResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CategoryListResponse" } } } } } }, "post": { "tags": [ "Categories" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCategoryRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CreateCategoryRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/CreateCategoryRequest" } } } }, "responses": { "201": { "description": "Created", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/CategoryDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CategoryDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CategoryDto" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/categories/{id}": { "get": { "tags": [ "Categories" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/CategoryDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CategoryDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CategoryDto" } } } }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "put": { "tags": [ "Categories" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateCategoryRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/UpdateCategoryRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/UpdateCategoryRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/CategoryDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CategoryDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CategoryDto" } } } }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "delete": { "tags": [ "Categories" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "No Content" }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/group-members": { "get": { "tags": [ "GroupMembers" ], "parameters": [ { "name": "groupId", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/groups": { "get": { "tags": [ "Groups" ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/GroupListResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/GroupListResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/GroupListResponse" } } } } } }, "post": { "tags": [ "Groups" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateGroupRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CreateGroupRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/CreateGroupRequest" } } } }, "responses": { "201": { "description": "Created", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/GroupDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/GroupDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/GroupDto" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/groups/{id}": { "get": { "tags": [ "Groups" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/GroupDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/GroupDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/GroupDto" } } } }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "put": { "tags": [ "Groups" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateGroupRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/UpdateGroupRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/UpdateGroupRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/GroupDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/GroupDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/GroupDto" } } } }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "delete": { "tags": [ "Groups" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "No Content" }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/icons": { "get": { "tags": [ "Icons" ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/WellKnownIconsResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/WellKnownIconsResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/WellKnownIconsResponse" } } } } } } }, "/api/v1/recurring": { "get": { "tags": [ "RecurringTransactions" ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RecurringTransactionListResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RecurringTransactionListResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RecurringTransactionListResponse" } } } } } }, "post": { "tags": [ "RecurringTransactions" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateRecurringTransactionRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CreateRecurringTransactionRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/CreateRecurringTransactionRequest" } } } }, "responses": { "201": { "description": "Created", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RecurringTransactionDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RecurringTransactionDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RecurringTransactionDto" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/recurring/{id}": { "get": { "tags": [ "RecurringTransactions" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RecurringTransactionDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RecurringTransactionDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RecurringTransactionDto" } } } }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "put": { "tags": [ "RecurringTransactions" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateRecurringTransactionRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/UpdateRecurringTransactionRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/UpdateRecurringTransactionRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/RecurringTransactionDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/RecurringTransactionDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/RecurringTransactionDto" } } } }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "delete": { "tags": [ "RecurringTransactions" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "No Content" }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/reports": { "get": { "tags": [ "Reports" ], "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer", "format": "int32" } }, { "name": "cursor", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/PeriodicReportListResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/PeriodicReportListResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/PeriodicReportListResponse" } } } } } } }, "/api/v1/reports/{id}": { "get": { "tags": [ "Reports" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/PeriodicReportListItemDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/PeriodicReportListItemDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/PeriodicReportListItemDto" } } } } } } }, "/api/v1/reports/{id}/html": { "get": { "tags": [ "Reports" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK" } } } }, "/api/v1/settlements/{id}": { "put": { "tags": [ "Settlements" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSettlementRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/UpdateSettlementRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/UpdateSettlementRequest" } } } }, "responses": { "200": { "description": "OK" } } } }, "/api/v1/settlements": { "post": { "tags": [ "Settlements" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSettlementRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CreateSettlementRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/CreateSettlementRequest" } } } }, "responses": { "200": { "description": "OK" } } } }, "/api/v1/transactions": { "get": { "tags": [ "Transactions" ], "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer", "format": "int32", "default": 50 } }, { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "type", "in": "query", "schema": { "type": "string" } }, { "name": "dateFrom", "in": "query", "schema": { "type": "string", "format": "date-time" } }, { "name": "dateTo", "in": "query", "schema": { "type": "string", "format": "date-time" } }, { "name": "categoryId", "in": "query", "schema": { "type": "string" } }, { "name": "accountId", "in": "query", "schema": { "type": "string" } }, { "name": "groupId", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/TransactionListResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/TransactionListResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/TransactionListResponse" } } } } } }, "post": { "tags": [ "Transactions" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateTransactionRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CreateTransactionRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/CreateTransactionRequest" } } } }, "responses": { "201": { "description": "Created", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/TransactionDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/TransactionDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/TransactionDto" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/transactions/{id}": { "get": { "tags": [ "Transactions" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/TransactionDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/TransactionDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/TransactionDto" } } } }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "put": { "tags": [ "Transactions" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateTransactionRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/UpdateTransactionRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/UpdateTransactionRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/TransactionDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/TransactionDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/TransactionDto" } } } }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "delete": { "tags": [ "Transactions" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "No Content" }, "404": { "description": "Not Found", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/transactions/transfer": { "post": { "tags": [ "Transactions" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateTransferRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/CreateTransferRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/CreateTransferRequest" } } } }, "responses": { "201": { "description": "Created", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/TransactionDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/TransactionDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/TransactionDto" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/transactions/bulk": { "post": { "tags": [ "Transactions" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkCreateTransactionRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/BulkCreateTransactionRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/BulkCreateTransactionRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/BulkTransactionResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/BulkTransactionResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/BulkTransactionResponse" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "put": { "tags": [ "Transactions" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkUpdateTransactionRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/BulkUpdateTransactionRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/BulkUpdateTransactionRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/BulkTransactionResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/BulkTransactionResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/BulkTransactionResponse" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/transactions/bulk-delete": { "post": { "tags": [ "Transactions" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkDeleteTransactionRequest" } }, "text/json": { "schema": { "$ref": "#/components/schemas/BulkDeleteTransactionRequest" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/BulkDeleteTransactionRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/BulkDeleteResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/BulkDeleteResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/BulkDeleteResponse" } } } }, "400": { "description": "Bad Request", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/v1/user-settings": { "get": { "tags": [ "UserSettings" ], "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/UserSettingsDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/UserSettingsDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/UserSettingsDto" } } } } } }, "put": { "tags": [ "UserSettings" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserSettingsUpdateDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/UserSettingsUpdateDto" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/UserSettingsUpdateDto" } } } }, "responses": { "200": { "description": "OK", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/UserSettingsDto" } }, "application/json": { "schema": { "$ref": "#/components/schemas/UserSettingsDto" } }, "text/json": { "schema": { "$ref": "#/components/schemas/UserSettingsDto" } } } } } } } }, "components": { "schemas": { "AccountDeletionAction": { "enum": [ 0, 1, 2 ], "type": "integer", "format": "int32" }, "AccountDto": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "icon": { "type": "string", "nullable": true }, "color": { "type": "string", "nullable": true }, "currencyCode": { "type": "string", "nullable": true }, "initialBalance": { "type": "number", "format": "double" }, "iconColor": { "type": "string", "nullable": true }, "order": { "type": "integer", "format": "int32" }, "shareInviteToken": { "type": "string", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "AccountListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/AccountDto" }, "nullable": true }, "totalCount": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "BudgetDto": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "categoryId": { "type": "string", "nullable": true }, "groupId": { "type": "string", "nullable": true }, "amount": { "type": "number", "format": "double" }, "currencyCode": { "type": "string", "nullable": true }, "period": { "type": "integer", "format": "int32" }, "startDate": { "type": "string", "format": "date-time" }, "endDate": { "type": "string", "format": "date-time", "nullable": true }, "isActive": { "type": "boolean" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "BudgetListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/BudgetDto" }, "nullable": true }, "totalCount": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "BulkCreateTransactionRequest": { "required": [ "items" ], "type": "object", "properties": { "items": { "maxItems": 100, "minItems": 1, "type": "array", "items": { "$ref": "#/components/schemas/CreateTransactionRequest" } } }, "additionalProperties": false }, "BulkDeleteResponse": { "type": "object", "properties": { "deleted": { "type": "integer", "format": "int32" }, "notFound": { "type": "array", "items": { "type": "string" }, "nullable": true } }, "additionalProperties": false }, "BulkDeleteTransactionRequest": { "required": [ "ids" ], "type": "object", "properties": { "ids": { "maxItems": 100, "minItems": 1, "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "BulkTransactionItemError": { "type": "object", "properties": { "index": { "type": "integer", "format": "int32" }, "id": { "type": "string", "nullable": true }, "error": { "type": "string", "nullable": true } }, "additionalProperties": false }, "BulkTransactionResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/TransactionDto" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/BulkTransactionItemError" }, "nullable": true } }, "additionalProperties": false }, "BulkUpdateTransactionItem": { "required": [ "amount", "currencyCode", "date", "id", "type" ], "type": "object", "properties": { "id": { "maxLength": 100, "minLength": 1, "type": "string" }, "type": { "maxLength": 20, "minLength": 1, "type": "string" }, "amount": { "maximum": 1.7976931348623157E+308, "minimum": 0.01, "type": "number", "format": "double" }, "currencyCode": { "maxLength": 3, "minLength": 1, "type": "string" }, "exchangeRate": { "type": "number", "format": "double", "nullable": true }, "convertedAmount": { "type": "number", "format": "double", "nullable": true }, "date": { "type": "string", "format": "date-time" }, "categoryId": { "maxLength": 100, "type": "string", "nullable": true }, "accountId": { "maxLength": 100, "type": "string", "nullable": true }, "toAccountId": { "maxLength": 100, "type": "string", "nullable": true }, "note": { "maxLength": 2000, "type": "string", "nullable": true }, "payee": { "maxLength": 200, "type": "string", "nullable": true }, "groupId": { "maxLength": 100, "type": "string", "nullable": true } }, "additionalProperties": false }, "BulkUpdateTransactionRequest": { "required": [ "items" ], "type": "object", "properties": { "items": { "maxItems": 100, "minItems": 1, "type": "array", "items": { "$ref": "#/components/schemas/BulkUpdateTransactionItem" } } }, "additionalProperties": false }, "CategoryDto": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "icon": { "type": "string", "nullable": true }, "color": { "type": "string", "nullable": true }, "categoryGroupId": { "type": "string", "nullable": true }, "type": { "type": "string", "nullable": true }, "order": { "type": "integer", "format": "int32" }, "isPinned": { "type": "boolean" }, "isDefault": { "type": "boolean" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "CategoryGroupDto": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "icon": { "type": "string", "nullable": true }, "color": { "type": "string", "nullable": true }, "order": { "type": "integer", "format": "int32" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "CategoryGroupListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/CategoryGroupDto" }, "nullable": true }, "totalCount": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "CategoryListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/CategoryDto" }, "nullable": true }, "totalCount": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "CreateAccountRequest": { "required": [ "currencyCode", "name" ], "type": "object", "properties": { "name": { "maxLength": 100, "minLength": 1, "type": "string" }, "icon": { "maxLength": 50, "type": "string", "nullable": true }, "color": { "maxLength": 20, "type": "string", "nullable": true }, "currencyCode": { "maxLength": 3, "minLength": 3, "type": "string" }, "initialBalance": { "type": "number", "format": "double" }, "iconColor": { "maxLength": 20, "type": "string", "nullable": true }, "order": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "CreateBudgetRequest": { "required": [ "amount", "currencyCode", "period", "startDate" ], "type": "object", "properties": { "name": { "maxLength": 200, "type": "string", "nullable": true }, "categoryId": { "maxLength": 100, "type": "string", "nullable": true }, "groupId": { "maxLength": 100, "type": "string", "nullable": true }, "amount": { "maximum": 1.7976931348623157E+308, "minimum": 0.01, "type": "number", "format": "double" }, "currencyCode": { "maxLength": 3, "minLength": 3, "type": "string" }, "period": { "type": "integer", "format": "int32" }, "startDate": { "type": "string", "format": "date-time" }, "endDate": { "type": "string", "format": "date-time", "nullable": true }, "isActive": { "type": "boolean" } }, "additionalProperties": false }, "CreateCategoryGroupRequest": { "required": [ "name" ], "type": "object", "properties": { "name": { "maxLength": 100, "minLength": 1, "type": "string" }, "icon": { "maxLength": 50, "type": "string", "nullable": true }, "color": { "maxLength": 20, "type": "string", "nullable": true }, "order": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "CreateCategoryRequest": { "required": [ "name", "type" ], "type": "object", "properties": { "type": { "maxLength": 20, "minLength": 1, "type": "string" }, "name": { "maxLength": 100, "minLength": 1, "type": "string" }, "icon": { "maxLength": 50, "type": "string", "nullable": true }, "color": { "maxLength": 20, "type": "string", "nullable": true }, "categoryGroupId": { "maxLength": 100, "type": "string", "nullable": true }, "order": { "type": "integer", "format": "int32" }, "isPinned": { "type": "boolean" } }, "additionalProperties": false }, "CreateGroupRequest": { "required": [ "name" ], "type": "object", "properties": { "name": { "maxLength": 100, "minLength": 1, "type": "string" }, "description": { "maxLength": 500, "type": "string", "nullable": true }, "icon": { "maxLength": 50, "type": "string", "nullable": true }, "color": { "maxLength": 20, "type": "string", "nullable": true } }, "additionalProperties": false }, "CreateRecurringTransactionRequest": { "required": [ "amount", "currencyCode", "frequency", "nextOccurrence", "startDate", "type" ], "type": "object", "properties": { "type": { "minLength": 1, "type": "string" }, "amount": { "type": "number", "format": "double" }, "currencyCode": { "maxLength": 3, "minLength": 3, "type": "string" }, "accountId": { "type": "string", "nullable": true }, "toAccountId": { "type": "string", "nullable": true }, "categoryId": { "type": "string", "nullable": true }, "groupId": { "type": "string", "nullable": true }, "frequency": { "minLength": 1, "type": "string" }, "customIntervalDays": { "type": "integer", "format": "int32", "nullable": true }, "startDate": { "type": "string", "format": "date-time" }, "endDate": { "type": "string", "format": "date-time", "nullable": true }, "nextOccurrence": { "type": "string", "format": "date-time" }, "isActive": { "type": "boolean" }, "note": { "maxLength": 500, "type": "string", "nullable": true }, "payee": { "maxLength": 200, "type": "string", "nullable": true }, "name": { "maxLength": 200, "type": "string", "nullable": true } }, "additionalProperties": false }, "CreateSettlementRequest": { "type": "object", "properties": { "groupId": { "type": "string", "nullable": true }, "fromUserId": { "type": "string", "nullable": true }, "toUserId": { "type": "string", "nullable": true }, "amount": { "type": "number", "format": "double" }, "currencyCode": { "type": "string", "nullable": true }, "status": { "type": "string", "nullable": true } }, "additionalProperties": false }, "CreateTransactionRequest": { "required": [ "amount", "currencyCode", "date", "type" ], "type": "object", "properties": { "type": { "maxLength": 20, "minLength": 1, "type": "string" }, "amount": { "maximum": 1.7976931348623157E+308, "minimum": 0.01, "type": "number", "format": "double" }, "currencyCode": { "maxLength": 3, "minLength": 1, "type": "string" }, "exchangeRate": { "type": "number", "format": "double", "nullable": true }, "convertedAmount": { "type": "number", "format": "double", "nullable": true }, "date": { "type": "string", "format": "date-time" }, "categoryId": { "maxLength": 100, "type": "string", "nullable": true }, "accountId": { "maxLength": 100, "type": "string", "nullable": true }, "toAccountId": { "maxLength": 100, "type": "string", "nullable": true }, "note": { "maxLength": 2000, "type": "string", "nullable": true }, "payee": { "maxLength": 200, "type": "string", "nullable": true }, "groupId": { "maxLength": 100, "type": "string", "nullable": true }, "receiptImagePath": { "maxLength": 500, "type": "string", "nullable": true } }, "additionalProperties": false }, "CreateTransferRequest": { "required": [ "amount", "currencyCode", "date", "fromAccountId", "toAccountId" ], "type": "object", "properties": { "fromAccountId": { "maxLength": 100, "minLength": 1, "type": "string" }, "toAccountId": { "maxLength": 100, "minLength": 1, "type": "string" }, "amount": { "maximum": 1.7976931348623157E+308, "minimum": 0.01, "type": "number", "format": "double" }, "currencyCode": { "maxLength": 3, "minLength": 3, "type": "string" }, "date": { "type": "string", "format": "date-time" }, "exchangeRate": { "type": "number", "format": "double", "nullable": true }, "convertedAmount": { "type": "number", "format": "double", "nullable": true }, "note": { "maxLength": 2000, "type": "string", "nullable": true } }, "additionalProperties": false }, "GroupDto": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "icon": { "type": "string", "nullable": true }, "color": { "type": "string", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "inviteUrl": { "type": "string", "description": "Full join URL for the group's active invite token, or null when none is set.", "nullable": true } }, "additionalProperties": false }, "GroupListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/GroupDto" }, "nullable": true }, "totalCount": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "PeriodicReportListItemDto": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "kind": { "type": "string", "nullable": true }, "periodStart": { "type": "string", "format": "date" }, "periodEnd": { "type": "string", "format": "date" }, "currency": { "type": "string", "nullable": true }, "language": { "type": "string", "nullable": true }, "generatedAt": { "type": "string", "format": "date-time" }, "summary": { "$ref": "#/components/schemas/PeriodicReportSummaryDto" } }, "additionalProperties": false }, "PeriodicReportListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/PeriodicReportListItemDto" }, "nullable": true }, "nextCursor": { "type": "string", "nullable": true } }, "additionalProperties": false }, "PeriodicReportSummaryDto": { "type": "object", "properties": { "spent": { "type": "number", "format": "double" }, "income": { "type": "number", "format": "double" }, "net": { "type": "number", "format": "double" }, "transactionCount": { "type": "integer", "format": "int32" }, "spentDeltaPct": { "type": "number", "format": "double", "nullable": true } }, "additionalProperties": false }, "ProblemDetails": { "type": "object", "properties": { "type": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "status": { "type": "integer", "format": "int32", "nullable": true }, "detail": { "type": "string", "nullable": true }, "instance": { "type": "string", "nullable": true } }, "additionalProperties": { } }, "RecurringTransactionDto": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "userId": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "type": { "type": "string", "nullable": true }, "amount": { "type": "number", "format": "double" }, "currencyCode": { "type": "string", "nullable": true }, "accountId": { "type": "string", "nullable": true }, "toAccountId": { "type": "string", "nullable": true }, "categoryId": { "type": "string", "nullable": true }, "groupId": { "type": "string", "nullable": true }, "frequency": { "type": "string", "nullable": true }, "customIntervalDays": { "type": "integer", "format": "int32", "nullable": true }, "startDate": { "type": "string", "format": "date-time" }, "endDate": { "type": "string", "format": "date-time", "nullable": true }, "nextOccurrence": { "type": "string", "format": "date-time" }, "autoPost": { "type": "boolean" }, "notifyBeforeDays": { "type": "integer", "format": "int32", "nullable": true }, "isActive": { "type": "boolean" }, "note": { "type": "string", "nullable": true }, "payee": { "type": "string", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "RecurringTransactionListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/RecurringTransactionDto" }, "nullable": true }, "totalCount": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "TransactionDto": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "type": { "type": "string", "nullable": true }, "amount": { "type": "number", "format": "double" }, "currencyCode": { "type": "string", "nullable": true }, "exchangeRate": { "type": "number", "format": "double", "nullable": true }, "convertedAmount": { "type": "number", "format": "double", "nullable": true }, "date": { "type": "string", "format": "date-time" }, "categoryId": { "type": "string", "nullable": true }, "accountId": { "type": "string", "nullable": true }, "toAccountId": { "type": "string", "nullable": true }, "note": { "type": "string", "nullable": true }, "payee": { "type": "string", "nullable": true }, "receiptImagePath": { "type": "string", "nullable": true }, "recurringTransactionId": { "type": "string", "nullable": true }, "groupId": { "type": "string", "nullable": true }, "source": { "type": "string", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "TransactionListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/TransactionDto" }, "nullable": true }, "totalCount": { "type": "integer", "format": "int32" }, "nextCursor": { "type": "string", "nullable": true } }, "additionalProperties": false }, "UpdateAccountRequest": { "required": [ "currencyCode", "name" ], "type": "object", "properties": { "name": { "maxLength": 100, "minLength": 1, "type": "string" }, "icon": { "maxLength": 50, "type": "string", "nullable": true }, "color": { "maxLength": 20, "type": "string", "nullable": true }, "currencyCode": { "maxLength": 3, "minLength": 3, "type": "string" }, "initialBalance": { "type": "number", "format": "double" }, "iconColor": { "maxLength": 20, "type": "string", "nullable": true }, "order": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "UpdateBudgetRequest": { "required": [ "amount", "currencyCode", "period", "startDate" ], "type": "object", "properties": { "name": { "maxLength": 200, "type": "string", "nullable": true }, "categoryId": { "maxLength": 100, "type": "string", "nullable": true }, "groupId": { "maxLength": 100, "type": "string", "nullable": true }, "amount": { "maximum": 1.7976931348623157E+308, "minimum": 0.01, "type": "number", "format": "double" }, "currencyCode": { "maxLength": 3, "minLength": 3, "type": "string" }, "period": { "type": "integer", "format": "int32" }, "startDate": { "type": "string", "format": "date-time" }, "endDate": { "type": "string", "format": "date-time", "nullable": true }, "isActive": { "type": "boolean" } }, "additionalProperties": false }, "UpdateCategoryGroupRequest": { "required": [ "name" ], "type": "object", "properties": { "name": { "maxLength": 100, "minLength": 1, "type": "string" }, "icon": { "maxLength": 50, "type": "string", "nullable": true }, "color": { "maxLength": 20, "type": "string", "nullable": true }, "order": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "UpdateCategoryRequest": { "required": [ "name", "type" ], "type": "object", "properties": { "type": { "maxLength": 20, "minLength": 1, "type": "string" }, "name": { "maxLength": 100, "minLength": 1, "type": "string" }, "icon": { "maxLength": 50, "type": "string", "nullable": true }, "color": { "maxLength": 20, "type": "string", "nullable": true }, "categoryGroupId": { "maxLength": 100, "type": "string", "nullable": true }, "order": { "type": "integer", "format": "int32" }, "isPinned": { "type": "boolean" } }, "additionalProperties": false }, "UpdateGroupRequest": { "required": [ "name" ], "type": "object", "properties": { "name": { "maxLength": 100, "minLength": 1, "type": "string" }, "description": { "maxLength": 500, "type": "string", "nullable": true }, "icon": { "maxLength": 50, "type": "string", "nullable": true }, "color": { "maxLength": 20, "type": "string", "nullable": true } }, "additionalProperties": false }, "UpdateRecurringTransactionRequest": { "type": "object", "properties": { "type": { "type": "string", "nullable": true }, "amount": { "type": "number", "format": "double", "nullable": true }, "currencyCode": { "maxLength": 3, "minLength": 3, "type": "string", "nullable": true }, "accountId": { "type": "string", "nullable": true }, "toAccountId": { "type": "string", "nullable": true }, "categoryId": { "type": "string", "nullable": true }, "groupId": { "type": "string", "nullable": true }, "frequency": { "type": "string", "nullable": true }, "customIntervalDays": { "type": "integer", "format": "int32", "nullable": true }, "startDate": { "type": "string", "format": "date-time", "nullable": true }, "endDate": { "type": "string", "format": "date-time", "nullable": true }, "nextOccurrence": { "type": "string", "format": "date-time", "nullable": true }, "isActive": { "type": "boolean", "nullable": true }, "note": { "maxLength": 500, "type": "string", "nullable": true }, "payee": { "maxLength": 200, "type": "string", "nullable": true }, "name": { "maxLength": 200, "type": "string", "nullable": true } }, "additionalProperties": false, "description": "Partial-update semantics: any field left null is preserved from the existing entity.\nUsed by the dashboard's pause/resume (only IsActive set) and full-edit forms alike." }, "UpdateSettlementRequest": { "type": "object", "properties": { "status": { "type": "string", "nullable": true } }, "additionalProperties": false }, "UpdateTransactionRequest": { "required": [ "amount", "currencyCode", "date", "type" ], "type": "object", "properties": { "type": { "maxLength": 20, "minLength": 1, "type": "string" }, "amount": { "maximum": 1.7976931348623157E+308, "minimum": 0.01, "type": "number", "format": "double" }, "currencyCode": { "maxLength": 3, "minLength": 1, "type": "string" }, "exchangeRate": { "type": "number", "format": "double", "nullable": true }, "convertedAmount": { "type": "number", "format": "double", "nullable": true }, "date": { "type": "string", "format": "date-time" }, "categoryId": { "maxLength": 100, "type": "string", "nullable": true }, "accountId": { "maxLength": 100, "type": "string", "nullable": true }, "toAccountId": { "maxLength": 100, "type": "string", "nullable": true }, "note": { "maxLength": 2000, "type": "string", "nullable": true }, "payee": { "maxLength": 200, "type": "string", "nullable": true }, "groupId": { "maxLength": 100, "type": "string", "nullable": true }, "receiptImagePath": { "maxLength": 500, "type": "string", "nullable": true } }, "additionalProperties": false }, "UserSettingsDto": { "type": "object", "properties": { "userId": { "type": "string", "nullable": true }, "primaryCurrency": { "type": "string", "nullable": true }, "dateFormat": { "type": "string", "nullable": true }, "decimalPlaces": { "type": "integer", "format": "int32" }, "weekStartDay": { "type": "integer", "format": "int32" }, "appLanguage": { "type": "string", "nullable": true }, "timezoneOffsetMinutes": { "type": "integer", "format": "int32" }, "reportsDisabled": { "type": "integer", "format": "int32" }, "updatedAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "UserSettingsUpdateDto": { "type": "object", "properties": { "primaryCurrency": { "type": "string", "nullable": true }, "primaryCurrencyCode": { "type": "string", "nullable": true }, "dateFormat": { "type": "string", "nullable": true }, "decimalPlaces": { "type": "integer", "format": "int32", "nullable": true }, "weekStartDay": { "type": "integer", "format": "int32", "nullable": true }, "appLanguage": { "type": "string", "nullable": true }, "timezoneOffsetMinutes": { "type": "integer", "format": "int32", "nullable": true }, "reportsDisabled": { "type": "integer", "format": "int32", "nullable": true } }, "additionalProperties": false }, "WellKnownCategoriesResponse": { "type": "object", "properties": { "version": { "type": "string", "nullable": true }, "metadata": { "$ref": "#/components/schemas/WellKnownMetadataDto" }, "categoryGroups": { "type": "array", "items": { "$ref": "#/components/schemas/WellKnownCategoryGroupDto" }, "nullable": true } }, "additionalProperties": false }, "WellKnownCategoryDto": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "icon": { "type": "string", "nullable": true }, "order": { "type": "integer", "format": "int32" }, "isDefault": { "type": "boolean" }, "isPinned": { "type": "boolean" }, "hints": { "type": "array", "items": { "type": "string" }, "nullable": true } }, "additionalProperties": false }, "WellKnownCategoryGroupDto": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "icon": { "type": "string", "nullable": true }, "color": { "type": "string", "nullable": true }, "order": { "type": "integer", "format": "int32" }, "type": { "type": "integer", "format": "int32" }, "categories": { "type": "array", "items": { "$ref": "#/components/schemas/WellKnownCategoryDto" }, "nullable": true } }, "additionalProperties": false }, "WellKnownIconCategoryDto": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "icons": { "type": "array", "items": { "type": "string" }, "nullable": true } }, "additionalProperties": false }, "WellKnownIconColorDto": { "type": "object", "properties": { "hex": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true } }, "additionalProperties": false }, "WellKnownIconsResponse": { "type": "object", "properties": { "version": { "type": "string", "nullable": true }, "metadata": { "$ref": "#/components/schemas/WellKnownMetadataDto" }, "library": { "type": "string", "nullable": true }, "categories": { "type": "array", "items": { "$ref": "#/components/schemas/WellKnownIconCategoryDto" }, "nullable": true }, "colors": { "type": "array", "items": { "$ref": "#/components/schemas/WellKnownIconColorDto" }, "nullable": true } }, "additionalProperties": false }, "WellKnownMetadataDto": { "type": "object", "properties": { "name": { "type": "string", "nullable": true }, "lastUpdated": { "type": "string", "nullable": true } }, "additionalProperties": false } }, "securitySchemes": { "Bearer": { "type": "apiKey", "description": "JWT or Personal Access Token. For JWT: \"Bearer {jwt_token}\". For PAT: \"Bearer lgpat_{token}\"", "name": "Authorization", "in": "header" } } }, "security": [ { } ], "tags": [ { "name": "Accounts" }, { "name": "Budgets" }, { "name": "Categories" }, { "name": "GroupMembers" }, { "name": "Groups" }, { "name": "Icons" }, { "name": "RecurringTransactions" }, { "name": "Reports" }, { "name": "Settlements" }, { "name": "Transactions" }, { "name": "UserSettings" } ] }