Hypamoon

Hypamoon Marketplaces API

A marketplace in an app: sellers with their own products, one checkout over several sellers, commission for the holder, and payouts through the holder's own Stripe account. Rules per country decide who may sell what, where.

GitHub OpenAPI

Operations 32

GET /marketplaces/{id} Get the marketplace of an app #
PUT /marketplaces/{id} Set up or change the marketplace #
GET /marketplaces/{id}/rules The rules for a seller, a delivery and a category #
GET /marketplaces/{id}/sellers List the sellers #
POST /marketplaces/{id}/sellers Invite a seller #
GET /marketplaces/{id}/sellers/{sellerId} Get one seller #
PATCH /marketplaces/{id}/sellers/{sellerId} Activate, suspend or close a seller #
POST /marketplaces/{id}/sellers/{sellerId}/suspend Suspend a seller #
POST /marketplaces/{id}/sellers/{sellerId}/reinstate Lift a seller's suspension #
PUT /marketplaces/{id}/sellers/{sellerId}/onboarding The seller's own details #
PATCH /marketplaces/{id}/sellers/{sellerId}/credentials/{type} Approve or reject a credential #
PUT /marketplaces/{id}/sellers/{sellerId}/tin The seller's tax number, above the reporting threshold #
GET /marketplaces/{id}/sellers/{sellerId}/shipping A seller's shipping methods #
PUT /marketplaces/{id}/sellers/{sellerId}/shipping Set a seller's shipping methods #
GET /marketplaces/{id}/listings List the products of the sellers #
POST /marketplaces/{id}/listings Add a product (seller) #
GET /marketplaces/{id}/listings/{listingId} Get one product #
PATCH /marketplaces/{id}/listings/{listingId} Change, approve or remove a product #
GET /marketplaces/{id}/suborders List the sub-orders #
GET /marketplaces/{id}/suborders/{suborderId} Get one sub-order #
PATCH /marketplaces/{id}/suborders/{suborderId} Mark a sub-order shipped or delivered #
POST /marketplaces/{id}/suborders/{suborderId}/refund Refund one sub-order #
POST /marketplaces/{id}/suborders/{suborderId}/reverse Take a payout back after a dispute #
GET /marketplaces/{id}/payments The connection with the holder's Stripe account #
PUT /marketplaces/{id}/payments Connect the holder's Stripe account #
DELETE /marketplaces/{id}/payments Disconnect the holder's Stripe account #
POST /marketplaces/{id}/quote Quote a cart over several sellers #
POST /marketplaces/{id}/checkout Start the checkout over several sellers #
GET /marketplaces/{id}/orders/{orderId} Get an order with its sub-orders #
GET /marketplaces/{id}/payouts Payouts per seller #
GET /marketplaces/{id}/readiness Is the marketplace ready to go live? #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/hypamoon-com/openapi/hypamoon-com-marketplaces-api-openapi.yml

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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/hypamoon-com:hypamoon-com-marketplaces-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

hypamoon-com-marketplaces-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Hypamoon Marketplaces API
  version: 1.0.0
  description: 'Hypamoon is the infrastructure a chat or an agent builds on for a business: sites and apps (with server code, sign-in and their own database), data and forms, a media library, domains, email from your own domain, phone numbers with voice AI, SMS and chat, payments (see https://hypamoon.com/docs/payments) and agents. The same project is reachable from a connected chat over MCP and from your own code over this REST API.


    Calls are inbound, plus outbound calls your assistant makes to people who expect them (POST /calls).


    Every request needs an API key: `Authorization: Bearer hm_live_...`, or `hm_test_...` in test mode. Each key has scopes and a rate limit of 120 requests per 60 seconds.


    An OAuth access token (`hm_oat_...`, from connecting an assistant such as Claude.ai or ChatGPT) works on every /api/v1 route as well, with the scopes the user granted on the consent screen. For your own app, create an API key in the portal instead.


    Every error is `application/problem+json` with a `type` URL that explains the fix (`https://hypamoon.com/docs/errors/`). Every response carries an `X-Request-Id` header; include it when you ask us for help.


    Field names are snake_case, except inside a call plan, which is stored exactly as you send it (camelCase). New fields may be added to a response at any time; renaming or removing one requires a new version.'
  contact:
    name: Hypamoon support
    url: https://hypamoon.com/docs
servers:
- url: https://api.hypamoon.com/api/v1
security:
- ApiKey: []
- OAuth2: []
tags:


# --- truncated at 32 KB (219 KB total) ---
# Full source: https://artifacts.apis.io/hypamoon-com/openapi/hypamoon-com-marketplaces-api-openapi.yml