Enrich a transaction

View as Markdown

Request

application/jsonTransactionInput

descriptorstring · length 1–512required

Response

Enrichment created.

application/jsonEnrichment

created_atstring · date-timerequired
contract_versionstringrequired
canonical_versionstringrequired
fingerprintstringrequired

Rate limit

debit_ti_v1operational_burst_protection · token_bucket

120 / min

per key · capacity 120 · refill 2/s

600 / min

per workspace · capacity 600 · refill 10/s

« 120 requetes / minute » est traduit en seau a jetons : capacite 120 (la rafale toleree) rechargee a 2 jetons / seconde (le regime durable). Une clef au repos peut envoyer 120 requetes d'un coup, puis 2 par seconde ; sur la premiere minute apres un repos, jusqu'a 240 passent. Le workspace, lui, borne la somme de toutes ses clefs a 600 / minute (capacite 600, 10 / s) : cent clefs ne font pas cent fois la limite.

This is not: sandbox_lifetime_quota · production_usage_quota · billing_entitlement · commercial_promise

Possible errors

Code
Status	Code	Title
`401`	`invalid_api_key`	The credential presented is not usable.
`403`	`account_inactive`	The workspace or organisation is not active.
`409`	`idempotency_conflict`	This Idempotency-Key has already been used for a different request.
`413`	`request_entity_too_large`	The request body exceeds the limit.
`415`	`unsupported_media_type`	The body must be application/json.
`422`	`invalid_input`	A constraint of the input schema is not met. The schema is closed: an unknown field is rejected rather than ignored.
`422`	`unknown_currency`	The currency is not in the reference list.
`429`	`rate_limited`	Too many requests. The rate limit for this key has been reached. Replay after the Retry-After delay.
`500`	`internal_error`	An internal error occurred.

All errors

POST/transactions/v1/enrichments

Serverhttps://api.noryo.app

IDEMPOTENCY_KEY=$(uuidgen)
curl -sS -X POST 'https://api.noryo.app/transactions/v1/enrichments' \
  -H "Authorization: Bearer $NORYO_API_KEY" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "descriptor": "CARTE 09/09 MONOPRIX PARIS 15",
  "direction": "outgoing",
  "occurred_at": "2026-09-09T07:31:00+02:00",
  "amount": {
    "value": "49.90",
    "currency": "EUR"
  },
  "payment": {
    "rail": "card",
    "mcc": "5411",
    "card_present": true
  },
  "location_hint": {
    "country": "FR"
  },
  "account_hint": {
    "iban": "FR7630006000011234567890189"
  },
  "external_transaction_id": "tx-2026-09-09-0042"
}'

Shell

Authorization

Header: Authorization
Type: http
Scheme: bearer

A credential of the txn family: nry_txn_sbx_<key_id>.<secret> in Sandbox, nry_txn_live_<key_id>.<secret> in Production. A nry_mer_* key is refused here, and vice versa: the families are isolated by the verifier's domain, not merely by a filter.

Response samples

{
  "enrichment_id": "enr_3f2504e0-4f89-41d3-9a0c-0305e82c3301",
  "created_at": "2026-09-09T05:31:02Z",
  "contract_version": "ti_v1",
  "canonical_version": "canon_ti_v1",
  "fingerprint": "canon_ti_v1:c2a1…",
  "signals": {
    "used": [
      "descriptor",
      "direction",
      "payment.rail",
      "location_hint.country",
      "occurred_at",
      "amount",
      "account_hint.iban",
      "external_transaction_id"
    ],
    "ignored": [
      "payment.mcc",
      "payment.card_present"
    ],
    "conflicting": []
  },
  "resolution": {
    "policy": {
      "outcome": "resolved",
      "archetype": "achat_carte",
      "missing": [],
      "policy_version": "ti_resolution_v1"
    },
    "normalized": {
      "descriptor": "CARTE 09 09 MONOPRIX PARIS",
      "signal": "CARTE 09 09 MONOPRIX PARIS",
      "useful": "09 09 MONOPRIX PARIS",
      "residual": "CARTE 09 09 MONOPRIX PARIS",
      "normalizer_version": "norm_ti_v3"
    },
    "counterparty": {
      "entity_id": "b83d1756-258c-4541-adc7-54eec83dbd3c",
      "name": "Monoprix",
      "kind": "brand",
      "evidence": {
        "match": "jetons",
        "pattern": "MONOPRIX",
        "coverage": 0.4
      },
      "semantics": {
        "roles": [
          "merchant"
        ],
        "activity": {
          "code": "retail.grocery",
          "label": "alimentation generale",
          "parent": "retail"
        },
        "provenance": {
          "nature": "curated",
          "source": "catalogue_cure",
          "strength": 0.75,
          "calibration": "non_calibree",
          "evidence": {
            "note": "La source est curee ; la derivation vers l'activite est deterministe.",
            "derivation": "categorie_de_depense_vers_activite",
            "categorie_source": "alimentation.supermarche"
          }
        },
        "legal_entity": {
          "entity_id": "5ecee4f8-fab0-444f-8711-29ff6e3f875a",
          "name": "Groupe Casino"
        },
        "recurring_model": "usually_one_off"
      }
    },
    "counterparty_type": "merchant",
    "counterparty_note": null,
    "category": {
      "slug": "alimentation.supermarche",
      "label": "Supermarché",
      "source": "entity_graph"
    },
    "identity_abstention": null,
    "intermediaries": [],
    "transaction_type": {
      "canonical": "card_purchase",
      "evidence": "rail_rule",
      "contradiction": null
    },
    "payment": {
      "rail": "card",
      "mechanism": "card_purchase",
      "note": "`rail` dit COMMENT l'argent a circule ; `transaction_type` dit CE QUE la transaction signifie. Un salaire recu par virement SEPA est les deux."
    },
    "signal_conflicts": [],
    "submerchant_lane": "none",
    "truncated_lane": "none",
    "confidence": {
      "entity": 0.97,
      "counterparty": 0.97,
      "transaction_type": 0.95,
      "category": 0.97,
      "location": 0,
      "calibration": "non_calibree"
    },
    "timings_ms": {
      "normalization": 4.1,
      "entity_resolution": 10.8,
      "submerchant": 2,
      "total": 18.1
    },
    "versions": {
      "graph": "onto_v1",
      "rules": "txtype_v1",
      "engine": "ti_v4",
      "resolution_policy": "ti_resolution_v1",
      "calibration": "non_calibree"
    }
  },
  "relationships": [],
  "series": [],
  "relationships_policy": {
    "detector_version": "rel_v1",
    "calibration": "non_calibree",
    "unresolved": [
      {
        "type": "series",
        "outcome": "single_occurrence",
        "occurrences": 1
      }
    ]
  }
}

JSON

Was this page helpful?