Direct API access to feedback,
analytics, and event streams.

GET/v1/submissions

Paginated access to feedback records with filtering by category, sentiment score, urgency level, integrity verdict, language, and date range.

GET/v1/submissions/{id}

Fetch a single submission record including verbatim original text, normalized translation, enrichment metadata, and integrity verification signals.

GET/v1/search/meaning

Cross-lingual semantic concept search across dense vector embeddings, returning relevance similarity scores.

GET/v1/analytics/{metric}

Retrieve registered analytical metrics with underlying formula definitions, sample sizes, population totals, and confidence intervals.

GET/v1/integrity/clusters

List identified coordinated campaign clusters with constituent submission IDs, triggering heuristics, and confidence scores.

POST/v1/actions

Create a tracked operational remediation task linked to a submission ID, with designated owner and target completion date.

PATCH/v1/actions/{id}

Update action status, attach resolution notes, and trigger post-resolution recurrence monitoring.

GET/v1/exports/corpus

Initiate asynchronous bulk data exports of submissions, translations, enrichments, and system audit logs.

curl https://api.yves.africa/v1/search/meaning \
  -H "Authorization: Bearer $YVES_TOKEN" \
  -G --data-urlencode "q=staff asked me for money" \
     --data-urlencode "since=2026-08-01" \
     --data-urlencode "min_similarity=0.62"

{
  "results": [
    {
      "id": "sub_9fK2xQ",
      "language": "es",
      "original": "En recepción me pidieron algo extra para adelantar mi cita.",
      "translation": "At reception they asked me for something extra to move my appointment forward.",
      "category": "staff-conduct",
      "urgency": "critical",
      "similarity": 0.874,
      "integrity": { "verdict": "clean", "signals": [] }
    }
  ],
  "interval": { "method": "wilson", "level": 0.95 },
  "n": 3184
}

The search query in English matches a submission in Spanish based on semantic intent rather than keyword matches. This ensures critical compliance and operational reports surface regardless of the vocabulary or language used by the respondent.