Skip to main content
POST

Overview

The medical consensus endpoint allows you to submit queries to get expert medical opinions and consensus from multiple sources. This is useful for getting second opinions, validating diagnoses, or exploring treatment options.

Rate Limiting

This endpoint is rate limited to prevent abuse:
  • Limit: Configurable requests per day (based on your plan)
  • Window: 24 hours
  • Behavior: Requests exceeding the limit will be blocked

Request Body

string
required
The medical query or question you want to get consensus on. This should be a clear, specific medical question or scenario.

Response

object
The created consensus request object

Status Codes

Accepted
Consensus request created successfully and is being processed
Bad Request
Invalid request body or missing required parameters
Unauthorized
Invalid or missing API key
Too Many Requests
Rate limit exceeded - wait before making another request
Internal Server Error
Server error occurred while processing the request

Next Steps

After creating a consensus request:
  1. Poll for results: Use the Get Consensus endpoint with the returned ID to check the status and retrieve results
  2. Clean up: Use the Delete Consensus endpoint to remove requests you no longer need