obscyro

Api / Disambiguate

/v1/disambiguate

Pick the right SNOMED concept when the same surface text could mean several things, given clinical context.

POST/v1/disambiguate

When MI could be myocardial infarction, mitral insufficiency, mental illness, or military intelligence, the right answer depends on what surrounds it. Send the ambiguous text plus a chunk of clinical context, and Obscyro scores each candidate by trigram similarity against its FSN and text definition.

Request body

  • textstringrequired

    The ambiguous phrase to resolve.

  • contextstringrequired

    Surrounding clinical context (sentence, paragraph, or document). Used to score candidates.

  • candidateCodesstring[]optional

    Optional pre-filtered candidate SCTIDs. When omitted, candidates are derived from /v1/normalize.

Coming soon

Full reference with the candidate, signal, and reasoning fields, plus tuning guidance, is being written.