MX Platform Tags API
The Tags API from MX Platform — 3 operation(s) for tags.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/mx-platform-tags-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.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 Tags API
version: 0.1.0
servers:
- url: https://api.mx.com
- url: https://int-api.mx.com
security:
- basicAuth: []
tags:
- name: Tags
paths:
/users/{user_guid}/tags:
get:
description: Use this endpoint to list all tags associated with the specified `user`. Each user includes the `Business` tag by default.
operationId: listTags
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
responses:
'200':
content:
application/vnd.mx.api.v1+json:
schema:
$ref: '#/components/schemas/TagsResponseBody'
description: OK
summary: List tags
tags:
- Tags
post:
description: Use this endpoint to create a new custom tag.
operationId: createTag
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
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/TagCreateRequestBody'
description: Tag object to be created with required parameters (tag_guid)
required: true
responses:
'200':
content:
application/vnd.mx.api.v1+json:
schema:
$ref: '#/components/schemas/TagResponseBody'
description: OK
summary: Create tag
tags:
- Tags
/users/{user_guid}/tags/{tag_guid}:
delete:
description: Use this endpoint to permanently delete a specific tag based on its unique GUID. If successful, the API will respond with status of `204 No Content`.
operationId: deleteTag
parameters:
- description: The unique id for a `tag`.
example: TAG-aef36e72-6294-4c38-844d-e573e80aed52
in: path
name: tag_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
responses:
'204':
description: No Content
summary: Delete tag
tags:
- Tags
get:
description: Use this endpoint to read the attributes of a particular tag according to its unique GUID.
operationId: readTag
parameters:
- description: The unique id for a `tag`.
example: TAG-aef36e72-6294-4c38-844d-e573e80aed52
in: path
name: tag_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
responses:
'200':
content:
application/vnd.mx.api.v1+json:
schema:
$ref: '#/components/schemas/TagResponseBody'
description: OK
summary: Read tag
tags:
- Tags
put:
description: Use this endpoint to update the name of a specific tag according to its unique GUID.
operationId: updateTag
parameters:
- description: The unique id for a `tag`.
example: TAG-aef36e72-6294-4c38-844d-e573e80aed52
in: path
name: tag_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/TagUpdateRequestBody'
description: Tag object to be updated with required parameter (tag_guid)
required: true
responses:
'200':
content:
application/vnd.mx.api.v1+json:
schema:
$ref: '#/components/schemas/TagResponseBody'
description: OK
summary: Update tag
tags:
- Tags
/users/{user_guid}/tags/{tag_guid}/transactions:
get:
description: Use this endpoint to get a list of all transactions associated with a particular tag according to the tags unique GUID. In other words, a list of all transactions that have been assigned to a particular tag using the create a tagging endpoint.
operationId: listTransactionsByTag
parameters:
- description: Filter transactions from this date.
example: '2015-09-20'
in: query
name: from_date
schema:
type: string
- 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 `tag`.
example: TAG-aef36e72-6294-4c38-844d-e573e80aed52
in: path
name: tag_guid
required: true
schema:
type: string
- description: Filter transactions to this date.
example: '2019-10-20'
in: query
name: to_date
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
responses:
'200':
content:
application/vnd.mx.api.v1+json:
schema:
$ref: '#/components/schemas/TransactionsResponseBody'
description: OK
summary: List transactions by tag
tags:
- Tags
components:
schemas:
TransactionResponse:
properties:
account_guid:
example: ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1
type:
- string
- 'null'
account_id:
example: account123
type:
- string
- 'null'
amount:
example: 61.11
type:
- number
- 'null'
category:
example: Groceries
type:
- string
- 'null'
category_guid:
example: CAT-9588eaad-90a4-bb5c-66c8-1812503d0db8
type:
- string
- 'null'
check_number_string:
example: '6812'
type:
- string
- 'null'
created_at:
example: '2016-10-06T09:43:42.000Z'
type:
- string
- 'null'
currency_code:
example: USD
type:
- string
- 'null'
date:
example: '2013-09-23T00:00:00.000Z'
type:
- string
- 'null'
description:
example: Whole foods
type:
- string
- 'null'
extended_transaction_type:
example: partner_transaction_type
type:
- string
- 'null'
guid:
example: TRN-265abee9-889b-af6a-c69b-25157db2bdd9
type:
- string
- 'null'
id:
example: transaction-265abee9-889b-af6a-c69b-25157db2bdd9
type:
- string
- 'null'
is_bill_pay:
example: false
type:
- boolean
- 'null'
is_direct_deposit:
example: false
type:
- boolean
- 'null'
is_expense:
example: true
type:
- boolean
- 'null'
is_fee:
example: false
type:
- boolean
- 'null'
is_income:
example: false
type:
- boolean
- 'null'
is_international:
example: false
type:
- boolean
- 'null'
is_overdraft_fee:
example: false
type:
- boolean
- 'null'
is_payroll_advance:
example: false
type:
- boolean
- 'null'
is_recurring:
example: false
type:
- boolean
- 'null'
is_subscription:
example: false
type:
- boolean
- 'null'
latitude:
example: -43.2075
type:
- number
- 'null'
localized_description:
example: This is a localized_description
type:
- string
- 'null'
localized_memo:
example: This is a localized_memo
type:
- string
- 'null'
longitude:
example: 139.691706
type:
- number
- 'null'
member_guid:
example: MBR-7c6f361b-e582-15b6-60c0-358f12466b4b
type:
- string
- 'null'
member_is_managed_by_user:
example: false
type:
- boolean
- 'null'
memo:
example: This is a memo
type:
- string
- 'null'
merchant_category_code:
example: 5411
type:
- integer
- 'null'
merchant_guid:
example: MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b
type:
- string
- 'null'
merchant_location_guid:
example: MCL-00024e59-18b5-4d79-b879-2a7896726fea
type:
- string
- 'null'
metadata:
example: some metadata
type:
- string
- 'null'
original_description:
example: WHOLEFDS TSQ 102
type:
- string
- 'null'
posted_at:
example: '2016-10-07T06:00:00.000Z'
type:
- string
- 'null'
status:
example: POSTED
type:
- string
- 'null'
top_level_category:
example: Food & Dining
type:
- string
- 'null'
transacted_at:
example: '2016-10-06T13:00:00.000Z'
type:
- string
- 'null'
type:
example: DEBIT
type:
- string
- 'null'
updated_at:
example: '2016-10-07T05:49:12.000Z'
type:
- string
- 'null'
user_guid:
example: USR-fa7537f3-48aa-a683-a02a-b18940482f54
type:
- string
- 'null'
user_id:
example: user123
type:
- string
- 'null'
type: object
TransactionsResponseBody:
properties:
pagination:
$ref: '#/components/schemas/PaginationResponse'
transactions:
items:
$ref: '#/components/schemas/TransactionResponse'
type: array
type: object
TagResponse:
properties:
guid:
example: TAG-aef36e72-6294-4c38-844d-e573e80aed52
type:
- string
- 'null'
name:
example: MY TAG
type:
- string
- 'null'
user_guid:
example: USR-11141024-90b3-1bce-cac9-c06ced52ab4c
type:
- string
- 'null'
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
TagUpdateRequestBody:
properties:
tag:
$ref: '#/components/schemas/TagUpdateRequest'
type: object
TagCreateRequestBody:
properties:
tag:
$ref: '#/components/schemas/TagCreateRequest'
type: object
TagsResponseBody:
properties:
pagination:
$ref: '#/components/schemas/PaginationResponse'
tags:
items:
$ref: '#/components/schemas/TagResponse'
type: array
type: object
TagResponseBody:
properties:
tag:
$ref: '#/components/schemas/TagResponse'
type: object
TagCreateRequest:
properties:
name:
example: MY TAG
type: string
required:
- name
type: object
TagUpdateRequest:
properties:
name:
example: MY TAG
type: string
required:
- name
type: object
securitySchemes:
basicAuth:
scheme: basic
type: http