Logo Medcloud Horizontal

Medcloud HIS

API Documentation

API HIS
HIS Integration
POST
/his
Return to documentation

API HIS

Endpoint for querying exam data for integration into medical records from HIS / RIS systems. Allows you to query exams, reports and images (quick access) for inclusion in the third-party system. The request uses the X-API-key provided by Medcloud.
Base URL: http://his.medcloud.co/v1/his
POST
/his
Generate Exam Links

Receives the accessionNumber of an exam from the HIS/RIS system and returns sharing links (FastShare), viewing in the DICOM viewer and direct access to the report. Links have an expiration date indicated in expiresAt.

‍

Header Parameters
Body Parameters
Response Codes (200)
Response Codes (Error/Status)
cURL / JSON 
curl -X POST https://his.example.co/v1/his \ -H "Content-Type: application/json" \ -H "X-API-key: sua-chave-aqui" \ -d '{ "accessionNumber": "AN202604180001" }'
Response · 200 
{ "link": "https://example.co/route?id=h361f9337...1778172110", "viewerLink": "https://example.co/route/viewer/?id=h361f9337...1778172110", "reportLink": "https://example.co/route?id=h361f9337...1778172110&op=report", "uuid": "h361f9337-58d1-45cb-b633-8972dc7b10761778172110", "expiresAt": "2026-05-08T14:21:50Z"
}
Response · Error 
{ "error": "Not Found", "message": "Exame com o accessionNumber informado não encontrado."
}