The merchants API from MX Technologies — 3 operation(s) for merchants.
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/mx-technologies:mx-technologies-merchants-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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: 3.2.0
info:
title: Mx Technologies Merchants API
contact:
name: MX Platform API
url: https://www.mx.com/products/platform-api
version: '1.0'
description: 'Operations tagged merchants across 2 of this provider''s published API definitions: mx-technologies-platform-openapi.yml, mx-technologies-platform-v20250224-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://int-api.mx.com
- url: https://api.mx.com
security:
- basicAuth: []
tags:
- name: Merchants
paths:
/merchant_locations/{merchant_location_guid}:
get:
description: This endpoint returns the specified `merchant_location` resource. The `merchant_location_guid` can be found on `transaction` objects.
operationId: readMerchantLocation
parameters:
- $ref: '#/components/parameters/merchantLocationGuid'
responses:
'200':
content:
application/vnd.mx.api.v1+json:
schema:
$ref: '#/components/schemas/MerchantLocationResponseBody'
description: OK
summary: Read merchant location
tags:
- Merchants
servers:
- url: https://int-api.mx.com
- url: https://api.mx.com
/merchants:
get:
description: This endpoint returns a paginated list of all the merchants in the MX system.
operationId: listMerchants
parameters:
- $ref: '#/components/parameters/merchantName'
- $ref: '#/components/parameters/page'
- $ref: '#/components/parameters/recordsPerPageMax1000'
responses:
'200':
content:
application/vnd.mx.api.v1+json:
schema:
$ref: '#/components/schemas/MerchantsResponseBody'
description: OK
summary: List merchants
tags:
- Merchants
servers:
- url: https://int-api.mx.com
- url: https://api.mx.com
/merchants/{merchant_guid}:
get:
description: Returns information about a particular merchant, such as a logo, name, and website.
operationId: readMerchant
parameters:
- $ref: '#/components/parameters/merchantGuid'
responses:
'200':
content:
application/vnd.mx.api.v1+json:
schema:
$ref: '#/components/schemas/MerchantResponseBody'
description: OK
summary: Read merchant
tags:
- Merchants
servers:
- url: https://int-api.mx.com
- url: https://api.mx.com
components:
schemas:
MerchantsResponseBody:
properties:
merchants:
items:
$ref: '#/components/schemas/MerchantResponse'
type: array
pagination:
$ref: '#/components/schemas/PaginationResponse'
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
MerchantResponseBody:
properties:
merchant:
$ref: '#/components/schemas/MerchantResponse'
type: object
MerchantLocationResponseBody:
properties:
merchant_location:
$ref: '#/components/schemas/MerchantLocationResponse'
type: object
MerchantResponse:
properties:
created_at:
example: '2017-04-20T19:30:12.000Z'
type:
- string
- 'null'
guid:
example: MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b
type:
- string
- 'null'
logo_url:
example: https://s3.amazonaws.com/MD_Assets/merchant_logos/comcast.png
type:
- string
- 'null'
name:
example: Comcast
type:
- string
- 'null'
updated_at:
example: '2018-09-28T21:13:53.000Z'
type:
- string
- 'null'
website_url:
example: https://www.xfinity.com
type:
- string
- 'null'
type: object
MerchantLocationResponse:
properties:
city:
example: Greenwood Village
type:
- string
- 'null'
country:
example: US
type:
- string
- 'null'
created_at:
example: '2020-04-13 21:05:09.000000000 Z'
type:
- string
- 'null'
guid:
example: MCL-00024e59-18b5-4d79-b879-2a7896726fea
type:
- string
- 'null'
latitude:
example: 39.5963005
type:
- number
- 'null'
longitude:
example: -104.89158799999998
type:
- number
- 'null'
merchant_guid:
example: MCH-09466f0a-fb58-9d1a-bae2-2af0afbea621
type:
- string
- 'null'
phone_number:
example: (303) 689-0728
type:
- string
- 'null'
postal_code:
example: '801121436'
type:
- string
- 'null'
state:
example: CO
type:
- string
- 'null'
street_address:
example: 8547 E Arapahoe Rd, Ste 1
type:
- string
- 'null'
updated_at:
example: '2020-04-13 21:05:09.000000000 Z'
type:
- string
- 'null'
type: object
PaginationResponse_2:
properties:
current_page:
description: The page delivered by the current response.
example: 1
type: integer
per_page:
description: The number of records delivered with each page.
example: 25
type: integer
total_entries:
description: The total number of records available.
example: 1
type: integer
total_pages:
description: The total number of pages available.
example: 1
type: integer
type: object
MerchantResponse_2:
properties:
created_at:
description: The date and time the merchant was created, represented in ISO 8601 format with a timestamp.
example: '2025-02-13T18:08:00+00:00'
type:
- string
- 'null'
guid:
description: The unique identifier for the merchant. Defined by MX.
example: MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b
type:
- string
- 'null'
logo_url:
description: The URL for a 100px X 100px logo for the merchant.
example: https://s3.amazonaws.com/MD_Assets/merchant_logos/comcast.png
type:
- string
- 'null'
name:
description: The name of the merchant.
example: Comcast
type:
- string
- 'null'
updated_at:
description: 'The date and time the resource was last updated in ISO 8601 format with a timestamp.
For categories, this field will always be `null` when `is_default` is `true`.
'
example: '2025-02-13T18:09:00+00:00'
type:
- string
- 'null'
website_url:
description: URL to the merchant's website.
example: https://www.example.com
type:
- string
- 'null'
type: object
MerchantLocationResponse_2:
properties:
city:
description: The city name.
example: North Kishaberg
type:
- string
- 'null'
country:
description: The country name.
example: US
type:
- string
- 'null'
created_at:
description: The date and time the merchant was created, represented in ISO 8601 format with a timestamp.
example: '2025-02-13T18:08:00+00:00'
type:
- string
- 'null'
guid:
description: The unique identifier for the merchant location. Defined by MX.
example: MCL-00024e59-18b5-4d79-b879-2a7896726fea
type:
- string
- 'null'
latitude:
description: The latitude of the location where the transaction occurred. The number is a signed decimal (for example, Rio de Janeiro's latitude is -22.9027800 and Tokyo's latitude is 35.689488).
example: 39.5963005
type:
- number
- 'null'
longitude:
description: The longitude of the location where the transaction occurred. The number is a signed decimal (for example, Rio de Janeiro's longitude is -43.2075000 and Tokyo's longitude is 139.691706).
example: -104.89158799999998
type:
- number
- 'null'
merchant_guid:
description: The unique identifier for the merchant. Defined by MX.
example: MCH-09466f0a-fb58-9d1a-bae2-2af0afbea621
type:
- string
- 'null'
phone_number:
description: The phone number of the merchant location.
example: (303) 689-0728
type:
- string
- 'null'
postal_code:
description: The postal code of the merchant location.
example: '801121436'
type:
- string
- 'null'
state:
description: The state abbreviation of the merchant location.
example: CO
type:
- string
- 'null'
street_address:
description: The street address of the merchant location.
example: 8547 E Arapahoe Rd, Ste 1
type:
- string
- 'null'
updated_at:
description: 'The date and time the resource was last updated in ISO 8601 format with a timestamp.
For categories, this field will always be `null` when `is_default` is `true`.
'
example: '2025-02-13T18:09:00+00:00'
type:
- string
- 'null'
type: object
parameters:
merchantLocationGuid:
description: The unique id for a `merchant_location`.
example: MCH-09466f0a-fb58-9d1a-bae2-2af0afbea621
in: path
name: merchant_location_guid
required: true
schema:
type: string
merchantName:
description: This will list only merchants in which the appended string appears.
example: Comcast
in: query
name: name
schema:
type: string
recordsPerPageMax1000:
description: This specifies the number of records to be returned on each page. Defaults to `25`. The valid range is from `10` to `1000`. If the value exceeds `1000`, the default value of `25` will be used instead.
example: 10
in: query
name: records_per_page
schema:
type: integer
page:
description: Results are paginated. Specify current page.
example: 1
in: query
name: page
schema:
type: integer
merchantGuid:
description: The unique id for a `merchant`.
example: MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b
in: path
name: merchant_guid
required: true
schema:
type: string
acceptVersion:
name: Accept-Version
in: header
required: true
schema:
type: string
default: v20250224
example: v20250224
description: MX Platform API version.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
basicAuth:
scheme: basic
type: http
x-refined-from:
- mx-technologies-platform-openapi.yml
- mx-technologies-platform-v20250224-openapi.yml