Synthesize

The Synthesize API returns a summary of guidelines and research for any clinical query

How it works

1

Craft query with or without patient context

2

Retrieve response with references & scores

API specifications

Initiate a synthesis

Initiate synthesis

post

https://cg-api-prod.system.comhttps://cg-api-stage.system.comhttps://cg-api-dev.system.comhttp://localhost:80

/v1/synthesis

Initiate synthesis.

Authorizations

APIKeyHeader

x-api-keystringRequired

Body

application/json

Payload to kickoff synthesis generation.

user_querystringRequired

User query.

population_filterany ofOptional

or

nullOptional

publication_filterany ofOptional

or

nullOptional

fast_modeany ofOptional

Fast mode flag for fast synthesis generation.

Default: false

booleanOptional

or

nullOptional

Responses

202

Job ID

application/json

204

No content

422

Validation Error

application/json

503

Service Unavailable

post

/v1/synthesis

HTTPcURLJavaScriptPython

POST /v1/synthesis HTTP/1.1
Host: cg-api-prod.system.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 270

{
  "user_query": "text",
  "population_filter": {
    "age": 1,
    "sex": "female",
    "race": "american indian or alaskan native"
  },
  "publication_filter": {
    "publication_date": {
      "start_year": 1,
      "end_year": 1
    },
    "publication_type": [
      "experimental trial"
    ],
    "publication_quality": "high"
  },
  "fast_mode": false
}

text

Retrieve response from job_id

Get synthesis by ID

get

https://cg-api-prod.system.comhttps://cg-api-stage.system.comhttps://cg-api-dev.system.comhttp://localhost:80

/v1/synthesis/{job_id}

Get synthesis.

Authorizations

APIKeyHeader

x-api-keystringRequired

Path parameters

job_idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/v1/synthesis/{job_id}

HTTPcURLJavaScriptPython

GET /v1/synthesis/{job_id} HTTP/1.1
Host: cg-api-prod.system.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "status": "not_exists",
  "synthesis": {
    "synthesis": {
      "text": "text",
      "references": [
        {
          "index": 1,
          "reference_text": "text",
          "document_title": "text",
          "authoring_societies_or_journal": [
            "text"
          ],
          "publish_date": "text",
          "link_or_doi": "text",
          "cited_by": 1,
          "source_type": "text",
          "authors": [
            "text"
          ],
          "journal_quality": "text"
        }
      ]
    },
    "response_flags": {
      "contains_guideline": true,
      "contains_trial": true,
      "quality": "low",
      "quantity": "limited",
      "relevance": "unanswered",
      "confidence_score": "low"
    },
    "synthesis_logs": {
      "total_time_seconds": 1,
      "guideline_search_time_seconds": 1,
      "guideline_lookup_time_seconds": 1,
      "evidence_retrieval_time_seconds": 1,
      "blending_time_seconds": 1
    }
  }
}

Data security

Synthesize can be integrated into electronic health records (EHRs) to receive de-identified patient data as context for clinical queries. No requests include patient identifiers.