MX Platform Current API
The Current API from MX Platform — 2 operation(s) for current.
OpenAPI Specification
openapi: 3.0.0
info:
contact:
name: MX Platform API
url: https://www.mx.com/products/platform-api
description: '
The MX Platform API is a powerful, fully-featured API designed to make
aggregating and enhancing financial data easy and reliable. It can
seamlessly connect your app or website to tens of thousands of financial
institutions.'
title: MX Platform Current API
version: 0.1.0
servers:
- url: https://api.mx.com
- url: https://int-api.mx.com
security:
- basicAuth: []
tags:
- name: Current
paths:
/users/{user_guid}/spending_plans/{spending_plan_guid}/iterations/current/iteration_items:
post:
description: This endpoint creates a new `spending_plan_iteration_item`.
operationId: createSpendingPlanIterationItem
parameters:
- description: The unique ID for the `spending_plan`.
example: SPL-e5f9a5bd-c5b3-4901-bdc0-62119b9db262
in: path
name: spending_plan_guid
required: true
schema:
type: string
- description: The unique id for a `user`.
example: USR-fa7537f3-48aa-a683-a02a-b18940482f54
in: path
name: user_guid
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SpendingPlanIterationItemCreateRequestBody'
description: Iteration item to be created with required parameter (planned_amount)
required: true
responses:
'200':
content:
application/vnd.mx.api.v1+json:
schema:
$ref: '#/components/schemas/SpendingPlanIterationItemResponse'
description: OK
summary: Create spending plan iteration item
tags:
- Current
get:
description: Use this endpoint to list all the spending plan `iteration_items` associated with the `iteration`.
operationId: listSpendingPlanIterationItems
parameters:
- description: Specify current page.
example: 1
in: query
name: page
schema:
type: integer
- description: Specify records per page.
example: 10
in: query
name: records_per_page
schema:
type: integer
- description: The unique id for a `user`.
example: USR-fa7537f3-48aa-a683-a02a-b18940482f54
in: path
name: user_guid
required: true
schema:
type: string
- description: The unique ID for the `spending_plan`.
example: SPL-e5f9a5bd-c5b3-4901-bdc0-62119b9db262
in: path
name: spending_plan_guid
required: true
schema:
type: string
responses:
'200':
content:
application/vnd.mx.api.v1+json:
schema:
$ref: '#/components/schemas/SpendingPlanIterationItemsResponseBody'
description: OK
summary: List spending plan iteration items
tags:
- Current
/users/{user_guid}/spending_plans/{spending_plan_guid}/iterations/current/iteration_items/{iteration_item_guid}:
delete:
description: Use this endpoint to delete a spending plan `iteration_item`.
operationId: deleteSpendingPlanIterationItem
parameters:
- description: The unique ID for a `user`.
example: USR-fa7537f3-48aa-a683-a02a-b18940482f54
in: path
name: user_guid
required: true
schema:
type: string
- description: The unique ID for the `spending_plan`.
example: SPL-e5f9a5bd-c5b3-4901-bdc0-62119b9db262
in: path
name: spending_plan_guid
required: true
schema:
type: string
- description: The unique ID for the `iteration_item`.
example: SII-a4dc1549-da28-1245-9c9c-53eee4cdfbe3
in: path
name: iteration_item_guid
required: true
schema:
type: string
responses:
'204':
description: No Content
summary: Delete spending plan iteration item
tags:
- Current
get:
description: Use this endpoint to read the attributes of a specific spending plan `iteration_item` according to its unique GUID.
operationId: readSpendingPlanIterationItem
parameters:
- description: Specify current page.
example: 1
in: query
name: page
schema:
type: integer
- description: Specify records per page.
example: 10
in: query
name: records_per_page
schema:
type: integer
- description: The unique id for a `user`.
example: USR-fa7537f3-48aa-a683-a02a-b18940482f54
in: path
name: user_guid
required: true
schema:
type: string
- description: The unique ID for the `spending_plan`.
example: SPL-e5f9a5bd-c5b3-4901-bdc0-62119b9db262
in: path
name: spending_plan_guid
required: true
schema:
type: string
- description: The unique ID for the `iteration_item`.
example: SII-a4dc1549-da28-1245-9c9c-53eee4cdfbe3
in: path
name: iteration_item_guid
required: true
schema:
type: string
responses:
'200':
content:
application/vnd.mx.api.v1+json:
schema:
$ref: '#/components/schemas/SpendingPlanIterationItemResponse'
description: OK
summary: Read a spending plan iteration item
tags:
- Current
put:
description: Use this endpoint to update an existing `spending_plan_iteration_item`.
operationId: updateSpendingPlanIterationItem
parameters:
- description: The unique id for a `user`.
example: USR-fa7537f3-48aa-a683-a02a-b18940482f54
in: path
name: user_guid
required: true
schema:
type: string
- description: The unique ID for the `spending_plan`.
example: SPL-e5f9a5bd-c5b3-4901-bdc0-62119b9db262
in: path
name: spending_plan_guid
required: true
schema:
type: string
- description: The unique ID for the `iteration_item`.
example: SII-a4dc1549-da28-1245-9c9c-53eee4cdfbe3
in: path
name: iteration_item_guid
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SpendingPlanIterationItemCreateRequestBody'
description: Iteration item to be updated with required parameter (planned_amount)
required: true
responses:
'200':
content:
application/vnd.mx.api.v1+json:
schema:
$ref: '#/components/schemas/SpendingPlanIterationItemResponse'
description: OK
summary: Update a spending plan iteration item
tags:
- Current
components:
schemas:
SpendingPlanIterationItemCreateRequestBody:
properties:
category_guid:
example: CAT-40faf068-abb4-405c-8f6a-e883ed541fff
type: string
item_type:
example: 1
type: number
planned_amount:
example: 110
type: number
scheduled_payment_guid:
example: SCP-c731988a-712f-4f83-9b3b-0aa5b3d5208b
type: string
top_level_category_guid:
example: CAT-9588eaad-90a4-bb5c-66c8-1812503d0db8
type: string
required:
- planned_amount
type: object
SpendingPlanIterationItemResponse:
properties:
actual_amount:
example: 345
nullable: true
type: number
category_guid:
example: CAT-40faf068-abb4-405c-8f6a-e883ed541fff
nullable: true
type: string
created_at:
example: '2016-10-13T18:08:00+00:00'
nullable: true
type: string
guid:
example: SPL-e5f9a5bd-c5b3-4901-bdc0-62119b9db262
nullable: true
type: string
item_type:
example: '0'
nullable: true
type: string
planned_amount:
example: 345
nullable: true
type: number
scheduled_payment_guid:
example: SCP-54bed778-6600-4262-908c-8822f141cc30
nullable: true
type: string
spending_plan_iteration_guid:
example: SPI-848e6648-3fa3-4632-ac8f-e65f03167102
nullable: true
type: string
top_level_category_guid:
example: CAT-50af068-abb4-405c-8f6a-e883ed541f4f
nullable: true
type: string
transaction_guids:
items:
example: TRN-265abee9-889b-af6a-c69b-25157db2bdd9
nullable: true
type: string
type: array
updated_at:
example: '2016-10-13T18:09:00.000Z'
nullable: true
type: string
user_guid:
example: USR-fa7537f3-48aa-a683-a02a-b18940482f54
nullable: true
type: string
type: object
PaginationResponse:
properties:
current_page:
example: 1
type: integer
per_page:
example: 25
type: integer
total_entries:
example: 1
type: integer
total_pages:
example: 1
type: integer
type: object
SpendingPlanIterationItemsResponseBody:
properties:
iteration_items:
items:
$ref: '#/components/schemas/SpendingPlanIterationItemResponse'
type: array
pagination:
$ref: '#/components/schemas/PaginationResponse'
type: object
securitySchemes:
basicAuth:
scheme: basic
type: http