KintsugiKintsugi

Get a marketplace by id

GET/marketplaces/{marketplace_id}

Fetch a single marketplace-facilitator registry row by id. Searched across every organization your credential owns, so no selector is needed for a known id.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Narrow the request to one organization (Organization-Id selector).

Connection-Idstring

Narrow the request to a connection's organization.

Entity-Idstring

Narrow the request to a platform entity's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Path parameters

marketplace_idstringRequired

The unique identifier of the marketplace.

Response

idstringRequired

Kintsugi's unique identifier for this marketplace registry row.

organizationIdstringRequired

Organization this marketplace registry belongs to.

clientNamestring

Display name of the organization this marketplace belongs to, or null when the organization has no name set.

connectionIdstring

Connection this marketplace channel is synced through, or null when it is not tied to one.

sourceIdstring

Secondary source id the connector reported for this channel, or null when it reported none.

sourceNamestring

Secondary source name the connector reported for this channel (e.g. Amazon, eBay), or null when it reported none.

sourceTypestring

Integration source that synced this registry row, or null when it is not tied to one.

statusPublicMarketplaceStatusEnumRequired

Confirmation state: whether transactions matched to this row are treated as marketplace-facilitated sales.

Available options:YESNONEEDS_REVIEW
processingStatusPublicMarketplaceProcessingStatusEnumRequired

Progress of the last change to status.

Available options:IDLEPROCESSINGCOMPLETEDFAILED
transactionsintegerRequired

Count of transactions currently matched to this registry row.

200

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

422

The request failed validation.

cURL
GET /marketplaces/{marketplace_id}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/marketplaces/{marketplace_id}
Response
{
"id": "mktpl_2mNpQr7Ls8f3k",
"organizationId": "orgn_2mNpQr7Ls8f3k",
"clientName": "Acme Corp",
"connectionId": "conn_2mNpQr7Ls8f3k",
"sourceId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"sourceName": "Acme Corp",
"sourceType": "SHOPIFY",
"status": "YES",
"processingStatus": "IDLE",
"transactions": 1
}
Get a marketplace by id (2026-07-21) | Kintsugi API Reference