Person APIs

Enrichment Feedback

Submit a freeform comment about a previously returned enrichment result. Unlike the rest of /person/* this endpoint is synchronous — it writes the feedback record and returns 200 inline (no queue, no request_id to poll). The request_id must reference an enrichment request owned by your API key’s user; feedback on another user’s request is rejected with 403 permission_denied.

POST https://api.nyne.ai/person/enrichment/feedback API key

Try it needs these required parameters:

Overview

Submit freeform feedback on a returned enrichment result (synchronous, 200).

Parameters

request_id string required

The request_id of the enrichment result you are commenting on.

comments string required

Your freeform feedback. Non-empty after trimming.

Credit usage

Credits are charged based on the matched configuration. The listed cost is the per-result unit price.

Feature	Credits	Notes
Feedback	0	Submitting feedback is free

Heads up

A positive credit balance is required before each request. Empty results do not burn credits.

Responses

200 Feedback stored

400 Missing request_id/comments or malformed JSON

401 Missing or invalid API credentials

403 permission_denied — the request_id is not owned by your account; or ip_not_allowed

404 request_not_found — no enrichment request matches the request_id

429 rate_limit_exceeded

503 service_unavailable — backing store unconfigured

A successful response wraps the payload in the { success, data, timestamp } envelope (also shown live in the panel on the right):

{
  "success": true,
  "data": {
    "success": true,
    "message": "Feedback submitted successfully",
    "request_id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4_1717000000_4271"
  },
  "timestamp": "2026-06-12T12:24:49"
}