curl --request POST \
  --url https://api.entendre.finance/v1/transactions \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "source_id": "src_507f1f77bcf86cd799439011",
  "legal_entity_id": "le_507f1f77bcf86cd799439011",
  "timestamp": "2026-08-31T12:00:00Z",
  "description": "Customer deposit",
  "direction": "debit",
  "currency": "USD",
  "gross": "100.00",
  "fee": "100.00",
  "net": "100.00",
  "external_reference": "bank-deposit-2026-09-01"
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    'X-API-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    source_id: 'src_507f1f77bcf86cd799439011',
    legal_entity_id: 'le_507f1f77bcf86cd799439011',
    timestamp: '2026-08-31T12:00:00Z',
    description: 'Customer deposit',
    direction: 'debit',
    currency: 'USD',
    gross: '100.00',
    fee: '100.00',
    net: '100.00',
    external_reference: 'bank-deposit-2026-09-01'
  })
};

fetch('https://api.entendre.finance/v1/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.entendre.finance/v1/transactions"

payload = {
    "source_id": "src_507f1f77bcf86cd799439011",
    "legal_entity_id": "le_507f1f77bcf86cd799439011",
    "timestamp": "2026-08-31T12:00:00Z",
    "description": "Customer deposit",
    "direction": "debit",
    "currency": "USD",
    "gross": "100.00",
    "fee": "100.00",
    "net": "100.00",
    "external_reference": "bank-deposit-2026-09-01"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "id": "txn_507f1f77bcf86cd799439011",
    "account_id": null,
    "organization_id": "org_507f1f77bcf86cd799439011",
    "legal_entity_id": "le_507f1f77bcf86cd799439011",
    "source_class": "fiat",
    "provider": "plaid",
    "vendor": null,
    "provider_category": null,
    "external": {
      "timestamp": "2026-08-31T12:00:00Z",
      "description": "Customer deposit",
      "direction": "credit",
      "quantity": null,
      "currency": "USD",
      "value_fiat": {
        "gross": "100.00",
        "fee": "0.00",
        "net": "100.00",
        "currency": "USD"
      }
    },
    "crypto": null,
    "bank": {
      "bank_name": "Example Bank",
      "account_last4": "4242",
      "counterparty_name": "Example Customer"
    },
    "card": null,
    "internal": {
      "transaction_type": "DEPOSIT",
      "status": "pending",
      "memo": null,
      "journal_entry_id": null
    },
    "created_at": null,
    "updated_at": null,
    "tag_ids": [
      "tag_507f1f77bcf86cd799439011"
    ]
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid path, query or request body.",
    "request_id": "req_example"
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or expired API Key",
    "request_id": "req_example",
    "suggested_action": "Send an API key in X-API-Key, or an OAuth access token as Authorization: Bearer. Refresh an expired access token.",
    "documentation_url": "https://entendre.ai/docs/get-started/authentication"
  }
}

{
  "error": {
    "code": "FORBIDDEN",
    "message": "Insufficient access to organization",
    "request_id": "req_example"
  }
}

{
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Resource not found",
    "request_id": "req_example"
  }
}

{
  "error": {
    "code": "CONFLICT",
    "message": "The resource state does not allow this operation.",
    "request_id": "req_example"
  }
}

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Retry after 30s.",
    "request_id": "req_example"
  }
}

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error",
    "request_id": "req_example"
  }
}

{
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "Service unavailable.",
    "request_id": "req_example"
  }
}