KintsugiKintsugi
API reference / List transactions with a blank address

List transactions with a blank address

GET/transactions/blank-addresses

List transactions that have no address yet, newest first, keyset-paginated, across every organization you own; narrow with Organization-Id, Connection-Id or Entity-Id. Only committed, non-marketplace transactions dated 2018 or later are listed, the same rows the blank-address count uses. A cursor is only valid for its search and scope.

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.

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.

/transactions/blank-addresses?limit=<limit>&cursor=<cursor>&search=<search>
limitinteger

Maximum number of items to return.

cursorstring

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

searchstring

Free-text search over transaction id, externalId, externalFriendlyId, description and customer name.

Response

itemsTransaction[]Required

The transactions on this page.

nextCursorstring

Opaque cursor for the next page, or null on the last page. Pass it back as cursor.

previousCursorstring

Opaque cursor for the previous page, or null on the first page. Pass it back as cursor.

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.

409

The request conflicts with existing state.

422

The request failed validation.

cURL
GET /transactions/blank-addresses?limit=50&cursor={cursor}&search={search}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/transactions/blank-addresses?limit=50&cursor={cursor}&search={search}
Response
{
"items": [
{
"id": "tran_2mNpQr7Ls8f3k",
"organizationId": "orgn_2mNpQr7Ls8f3k",
"externalId": "order-1001",
"externalFriendlyId": "INV-1001",
"date": "2026-07-28T12:00:00Z",
"type": "SALE",
"status": "PENDING",
"direction": "SALE",
"customerId": "cust_2mNpQr7Ls8f3k",
"customerName": "Acme Corp",
"customerExternalId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"connectionId": "conn_2mNpQr7Ls8f3k",
"source": "API",
"description": "Annual software subscription",
"currency": "AED",
"totalAmount": "10.00",
"taxableAmount": "10.00",
"totalTaxAmountImported": "10.00",
"totalTaxAmountCalculated": "10.00",
"totalTaxLiabilityAmount": "10.00",
"totalDiscount": "10.00",
"finalTotalAmount": "10.00",
"hasExemptions": false,
"locked": false,
"marketplace": false,
"shopDate": "2026-07-21",
"processingStatus": "PROCESSED",
"taxLiabilitySource": "CALCULATED",
"addressStatus": "UNVERIFIED",
"destinationCurrency": "AED",
"conversionRate": "25350.123456789",
"convertedTotalAmount": "10.00",
"convertedTotalTaxLiabilityAmount": "10.00",
"convertedTotalDiscount": "10.00",
"convertedFinalTotalAmount": "10.00",
"createdAt": "2026-07-28T12:00:00Z",
"updatedAt": "2026-07-28T12:00:00Z",
"addresses": [
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"type": "BILL_TO",
"street1": "123 Main St",
"street2": "Suite 400",
"city": "San Francisco",
"county": "San Francisco County",
"state": "CA",
"postalCode": "94107",
"country": "US",
"fullAddress": "123 Main St, San Francisco, CA 94107, US",
"phone": "+1 415 555 0100",
"isUnincorporated": false,
"status": "UNVERIFIED"
}
],
"items": [
{
"id": "txim_2mNpQr7Ls8f3k",
"productId": "prod_2mNpQr7Ls8f3k",
"productName": "Widget",
"description": "Annual software subscription",
"quantity": "3",
"amount": "10.00",
"subtotal": "10.00",
"discount": "10.00",
"taxAmountImported": "10.00",
"taxAmountCalculated": "10.00",
"taxLiabilityAmount": "10.00",
"exempt": false,
"convertedAmount": "10.00",
"convertedSubtotal": "10.00",
"convertedDiscount": "10.00",
"convertedTaxAmountImported": "10.00",
"convertedTaxLiabilityAmount": "10.00",
"taxItems": [
{
"name": "CA STATE TAX",
"rate": "0.082500000",
"amount": "10.00",
"convertedAmount": "10.00",
"jurisdictionType": "STATE",
"jurisdictionName": "CA"
}
]
}
]
}
],
"nextCursor": "eyJpZCI6InRyYW5fMm1OcFFyN0xzOGYzayJ9",
"previousCursor": "eyJpZCI6InRyYW5fMm1OcFFyN0xzOGYzayJ9",
"hasMore": false,
"hasPrevious": false
}
List transactions with a blank address (2026-07-21) | Kintsugi API Reference