Read a past enrichment

Returns the stored result. Reading is free and never bills.

The retrieval object says what this read costs; the original object says what the enrichment cost when it happened. Two different questions, two objects.

Request

Response

The stored result.

application/jsonStoredEnrichment

Possible errors

Code
Status	Code	Title
`400`	`invalid_idempotency_key`	Invalid Idempotency-Key The Idempotency-Key header is missing or malformed.
`400`	`invalid_request`	Invalid request The request does not match the documented shape.
`401`	`invalid_api_key`	Invalid API credential The API credential is missing, malformed, revoked, or unknown.
`403`	`account_inactive`	Account inactive The organization or the workspace is not active.
`403`	`insufficient_scope`	Insufficient scope The credential does not carry the scope this operation requires.
`403`	`production_not_enabled`	Production access not enabled This credential is not allowed to call the production environment.
`410`	`result_content_expired`	Result content expired The result content was purged and is no longer available.
`429`	`rate_limited`	Rate limited Too many requests. Retry after the delay given by Retry-After.
`500`	`internal_error`	Internal error An unexpected error occurred. Quote the request_id when contacting support.

All errors

GET/merchant/v1/enrichments/{enrichment_id}

Serverhttps://api.noryo.app

Sandbox and Production share the API surface; the credential decides which.

curl -sS -g -X GET 'https://api.noryo.app/merchant/v1/enrichments/{enrichment_id}' \
  -H "Authorization: Bearer $NORYO_API_KEY"

Shell

Authorization

Header: Authorization
Type: http
Scheme: bearer

Authorization: Bearer nry_mer_sbx_<key_id>.<secret>

The prefix carries the environment: nry_mer_sbx_ for Sandbox, nry_mer_live_ for Production. The secret is shown once, at creation, and is never recoverable. There is no rotation operation: to replace a key, create a new one, deploy it, then revoke the old one.

Response samples

Schema structure

{
  "enrichment_id": "enr_7f3c1e20-…",
  "merchant": {
    "name": "McDonald's",
    "category": "alimentation.restaurant",
    "logo_url": "<string · uri>",
    "location": {
      "city": "PARIS",
      "postal_code": "75018"
    },
    "confidence": "<number · 0–1>"
  },
  "enrichment": {
    "status": "<string>",
    "reason": "<string>",
    "environment": "<string>",
    "source": "<string>",
    "customized": "<boolean>",
    "rules": [
      {
        "id": "<string · uuid>",
        "version": "<integer ≥ 1>"
      }
    ]
  },
  "retrieval": {
    "billable": "<boolean = false>",
    "units": "<integer = 0>"
  },
  "original": {
    "billable": "<boolean>",
    "units": "<integer>"
  }
}

JSON

Was this page helpful?