KintsugiKintsugi

List transactions matched to a marketplace

GET/marketplaces/{marketplace_id}/transactions

List transactions matched to one marketplace, keyset-paginated. Searched across every organization your credential owns, so no selector is needed. Includes transactions with no customer. Newest first unless orderBy/order say otherwise. Page with limit and cursor.

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.

Query

Every query parameter below is optional. Combine as many as you need and append them to the endpoint as a query string. The example shows a few to get you started.

/marketplaces/{marketplace_id}/transactions?orderBy=<orderBy>&order=<order>&limit=<limit>
orderByPublicMarketplaceTransactionSortEnum

Field to sort by. Omit both orderBy and order for newest first (date descending). Missing values sort last in both directions.

Available options:datecustomerNamestatestatus
orderPublicMarketplaceSortOrderEnum

Sort direction. Defaults to asc when orderBy or order is set alone; orderBy defaults to date.

Available options:ascdesc
limitinteger

Maximum number of items to return.

cursorstring

Opaque cursor from a prior response's nextCursor or previousCursor. Omit for the first page.

Response

itemsMarketplaceTransaction[]Required

The results on this page. Empty when there are none.

nextCursorstring

Opaque cursor for the next page. null when this is the last page. Send it back as cursor; do not parse it.

previousCursorstring

Opaque cursor for the previous page. null when this is the first page. Send it back as cursor; do not parse it.

hasMoreboolean

Whether a page exists after this one.

hasPreviousboolean

Whether a page exists before this one.

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}/transactions?orderBy={orderBy}&order={order}&limit=50
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/marketplaces/{marketplace_id}/transactions?orderBy={orderBy}&order={order}&limit=50
Response
{
"items": [
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"organizationId": "orgn_2mNpQr7Ls8f3k",
"connectionId": "conn_2mNpQr7Ls8f3k",
"customerId": "cust_2mNpQr7Ls8f3k",
"customerName": "Acme Corp",
"description": "Annual software subscription",
"date": "2026-07-28T12:00:00Z",
"state": "CA",
"amount": "10.00",
"convertedAmount": "10.00",
"currency": "AED",
"status": "PENDING",
"source": "SHOPIFY",
"taxLiabilitySource": "CALCULATED",
"totalTaxLiabilityAmount": "10.00"
}
],
"nextCursor": "eyJpZCI6InRyYW5fMm1OcFFyN0xzOGYzayJ9",
"previousCursor": "eyJpZCI6InRyYW5fMm1OcFFyN0xzOGYzayJ9",
"hasMore": false,
"hasPrevious": false
}
List transactions matched to a marketplace (2026-07-21) | Kintsugi API Reference