KintsugiKintsugi
API reference / List transactions with an invalid address

List transactions with an invalid address

GET/transactions/invalid-addresses

List transactions that need an address fix, keyset-paginated, across every organization you own; narrow with Organization-Id, Connection-Id or Entity-Id. Includes transactions marked invalid and verified ones whose US or unknown-country ship-to address is still invalid. A cursor is only valid for its sort, filters 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/invalid-addresses?sort=<sort>&limit=<limit>&cursor=<cursor>
sortPublicInvalidAddressSortEnum

usFirst (default) lists US addresses first, then other countries in country order, then rows with no country. countryAsc and countryDesc order by country, with no-country rows last. Newest first breaks ties.

Available options:usFirstcountryAsccountryDesc
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.

countrystring

ISO-3166 country code of the invalid address.

hasCountryboolean

Keep rows whose invalid address has (true) or lacks (false) a country.

hasStateboolean

Keep rows whose invalid address has (true) or lacks (false) a state.

hasCityboolean

Keep rows whose invalid address has (true) or lacks (false) a city.

hasCountyboolean

Keep rows whose invalid address has (true) or lacks (false) a county.

hasPostalCodeboolean

Keep rows whose invalid address has (true) or lacks (false) a postal code.

addressNotEmptyboolean

true keeps addresses with at least one of state, city, postal code or county; false keeps only fully empty ones.

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/invalid-addresses?sort=usFirst&limit=50&cursor={cursor}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/transactions/invalid-addresses?sort=usFirst&limit=50&cursor={cursor}
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 an invalid address (2026-07-21) | Kintsugi API Reference