Medical

Turn a Hebrew question into an English record query

Translate a Hebrew question into an English query for your record search and model. English terms, numbers and dates in the question are kept exactly (Hebrew day-first dates become ISO dates). Hebrew spellings of English drug names are mapped back to English, preferring the patient's own terms from known_terms and the account terms over the built-in lexicon.

Quota. Consumes the monthly character quota: the length of text. Refunded when the query cannot be verified (502 unverified) or the provider fails.

Limits. text up to 2,000 characters.

post/v1/medical/query

Request

  • Base URL: https://hc.itsbaba.com
  • URL: https://hc.itsbaba.com/v1/medical/query
  • Auth: HTTP bearer

Request body

textstring required

The Hebrew question, up to 2,000 characters.

known_termsstring[]

English terms from the patient's record, used to map Hebrew spellings back. Up to 500. Account terms are added automatically.

glossaryobject

English term → Hebrew rendering, used to map the Hebrew back to English.

Example request

{
  "text": "האם המטופלת עדיין לוקחת מטפורמין?",
  "known_terms": [
    "metformin",
    "lisinopril"
  ],
  "glossary": {
    "metformin": "מטפורמין"
  }
}

Response

English query

querystring required

English query for your record search.

Example response

{
  "query": "Is the patient still taking metformin?",
  "terms": [
    {
      "hebrew": "מטפורמין",
      "english": "metformin",
      "source": "known_terms"
    }
  ],
  "usage": {
    "characters": 33
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.