TransactionsSoon
Search transactions
Search closed real-estate transactions with optional filters (date, property type, price, location ids, and a GeoJSON polygon), cursor-paginated. Overlapping records from different sources are reconciled on the fly: a duplicate is suppressed and merged into the surviving row, which then carries a matched block. Filters are sent in the request body rather than the query string so a large geoshape polygon is not constrained by URL length.
Authorization
apiKey X-API-KEY<token>
Value for the X-API-KEY header parameter.
In: header
The new Transaction resource
Response Body
curl -X POST "https://example.com/transactions/search" \ -H "Content-Type: application/json" \ -d '{}'{ "data": [ { "id": "019476e2-8d1f-7a3c-9b2e-1f6a2c4e8b90", "source": "FR_DVF", "externalRef": "2024-123456", "dateMutation": "2024-03-15", "nature": "SALE", "propertyType": "FLAT", "price": { "amountCents": 45000000, "currency": "EUR", "pricePerSqmCents": 692307 }, "areas": { "livingAreaSqm": 65, "landAreaSqm": 200, "roomsCount": 3 }, "location": { "cityId": "019476e2-8d1f-7a3c-9b2e-1f6a2c4e8b90", "districtId": "019476e2-9a2b-7c4d-8e5f-2a3b4c5d6e7f", "neighborhoodId": "019476e2-ab3c-7d5e-9f60-3b4c5d6e7f80", "geoPoint": { "lon": 2.3522, "lat": 48.8566 } }, "address": { "streetNumber": "10", "streetName": "Rue de Rivoli" }, "cadastralRef": "75101000AB0001", "lots": [ { "role": "MAIN", "kind": "FLAT" } ], "building": { "constructionEra": "1948-1974", "elevator": true }, "amenities": { "balcony": true, "cellar": true }, "createdAt": "2026-01-15T10:30:00+00:00", "updatedAt": "2026-01-15T10:30:00+00:00", "matched": { "withTransactionId": "019476e2-cd4e-7f70-a180-4c5d6e7f8091", "score": 0.95, "mergedFields": [ "building", "amenities" ] }, "sourcePayload": { "id_mutation": "2024-123456", "type_local": "Appartement" } } ], "meta": { "count": 20, "nextCursor": "eyJ1dWlkIjoiMDE5NDc2ZTItOGQxZi03YTNjLTliMmUtMWY2YTJjNGU4YjkwIiwiZGF0ZSI6IjIwMjQtMDMtMTUifQ==" }}