Synchronously enrich transactions

1 from ntropy_sdk import SDK 2 3 sdk = SDK("cd1H...Wmhl") 4 enriched = sdk.transactions.create( 5 id="xbx8YP14g565Xk", 6 description="SQ* STARBUCKS 10 Union Sq", 7 account_holder_id="35b927b6-6fda-40aa-93b8-95b47c2b2cad", 8 amount=10.0, 9 entry_type="outgoing", 10 date="2024-03-30", 11 currency="USD", 12 location=dict(country="US"), 13 )

1 { 2 "created_at": "2024-03-30T00:00:00Z", 3 "id": "xbx8YP14g565Xk", 4 "entities": { 5 "counterparty": { 6 "type": "organization", 7 "id": "d4bc3c80-ec1a-3da2-836e-2a4ca4758be5", 8 "name": "Starbucks", 9 "website": "starbucks.com", 10 "logo": "https://logos.ntropy.com/starbucks.com", 11 "mccs": [ 12 5814 13 ] 14 }, 15 "intermediaries": [ 16 { 17 "id": "916bc837-55ef-3106-88f6-5a8269ca9f2a", 18 "name": "Square, Inc.", 19 "website": "squareup.com", 20 "logo": "https://logos.ntropy.com/squareup.com", 21 "mccs": [ 22 1 23 ] 24 } 25 ] 26 }, 27 "categories": { 28 "general": "coffee shop", 29 "accounting": "operational expenses" 30 }, 31 "location": { 32 "raw_address": "10 Union Square E, New York, New York 10003, United States", 33 "structured": { 34 "street": "Union Square East", 35 "city": "New York", 36 "state": "New York", 37 "postcode": "10003", 38 "country_code": "US", 39 "country": "United States", 40 "house_number": "10", 41 "latitude": 40.734834, 42 "longitude": -73.989782, 43 "google_maps_url": "https://www.google.com/maps/search/?api=1&query=40.734834,-73.989782", 44 "apple_maps_url": "https://maps.apple.com/?q=40.734834,-73.989782", 45 "store_number": "store_number" 46 } 47 } 48 }

Enriches a transaction with information about entities, locations and categories. Besides the original id that was submitted, the response only contains the enriched fields.

To view the complete transaction, including the original fields, such as description or amount, you can use any of the Transactions API listing methods.

Complete guide: Transaction Enrichment.

Enriches a transaction with information about entities, locations and categories. Besides the original `id` that was submitted, the response only contains the enriched fields. To view the complete transaction, including the original fields, such as description or amount, you can use any of the Transactions API listing methods. Complete guide: [Transaction Enrichment](../../../enrichment/introduction).

Authentication

X-Api-Keystring

API Key authentication via header

Headers

X-Application-IdstringRequired

Request

This endpoint expects an object.

idstringRequired>=1 character

A unique identifier of the transaction

descriptionstringRequired>=0 characters<=1024 characters

The description string of the transaction

datestringRequiredformat: "date"

The date that the transaction was posted. Uses ISO 8601 format (YYYY-MM-DD)

amountdoubleRequired>=0

The amount of the transaction in the currency. Must be a positive value. For example, if the currency is USD, then it’s the amount in dollars.

entry_typeenumRequired

The direction of the flow of the money from the perspective of the account holder. outgoing to represent money leaving the account, such as purchases or fees, while incoming represents money entering the account, such as income or refunds.

Allowed values:

currencyenumRequired

The currency of the transaction in ISO 4217 format

account_holder_idstringRequired

The unique ID of the account holder. Unsetting it will disable categorization.

locationobjectOptional

Location of where the transaction has taken place. This can greatly improve entity identification, especially under ambiguity.

Response

Enriched transactions.

created_atdatetime

The timestamp of when the account holder was created.

idstring>=1 character

A unique identifier for the transaction. If two transactions are submitted with the same id the most recent one will replace the previous one.

entitiesobject or null

Entities found by identity identification

categoriesobject or null

locationobject or null

errorobject or null

Authentication

Headers

Request

Response

Errors