Skip to main content
POST
/
v1
/
tools
/
comprehend
/
medical
cURL
curl --location --request POST https://api.writer.com/v1/tools/comprehend/medical \
 --header "Authorization: Bearer <token>" \
 --header "Content-Type: application/json" \
--data-raw '{"content":"the symptoms are soreness, a temperature and cough","response_type":"Entities"}'
{
  "entities": [
    {
      "category": "<string>",
      "begin_offset": 123,
      "end_offset": 123,
      "text": "<string>",
      "traits": [
        {
          "score": 123,
          "name": "<string>"
        }
      ],
      "concepts": [
        {
          "code": "<string>",
          "score": 123,
          "description": "<string>"
        }
      ],
      "score": 123,
      "attributes": [
        {
          "category": "<string>",
          "relationship_score": 123,
          "begin_offset": 123,
          "end_offset": 123,
          "text": "<string>",
          "traits": [
            {
              "score": 123,
              "name": "<string>"
            }
          ],
          "concepts": [
            {
              "code": "<string>",
              "score": 123,
              "description": "<string>"
            }
          ],
          "score": 123,
          "relationship_type": "<string>",
          "type": "<string>"
        }
      ],
      "type": "<string>"
    }
  ]
}
Deprecation notice: The medical comprehend API endpoint at /v1/tools/comprehend/medical is deprecated and will be removed on December 22, 2025.Migration path: Use the LLM tool in chat completions to delegate medical analysis tasks to the palmyra-med model. This approach provides the same medical analysis capabilities within a chat completion workflow. See the migration guide for detailed instructions.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your Writer API key.

Body

application/json
​
content
string
required

The text to analyze.

​
response_type
enum<string>
required

The structure of the response to return. Entities returns medical entities, RxNorm returns medication information, ICD-10-CM returns diagnosis codes, and SNOMED CT returns medical concepts.

Available options:
Entities,
RxNorm,
ICD-10-CM,
SNOMED CT

Response

200 - application/json
​
entities
medical_comprehend_entity · object[]
required

An array of medical entities extracted from the input text.