Skip to main content
GET
/
medical
/
v1
/
message
/
{messageId}
Get Message Status
curl --request GET \
  --url https://api.sandbox.metriport.com/medical/v1/message/{messageId} \
  --header 'x-api-key: <api-key>'
import { MetriportMedicalApi } from "@metriport/api-sdk";

const metriport = new MetriportMedicalApi("YOUR_API_KEY");

const status = await metriport.getMessageStatus(
  "00000000-0000-0000-0000-000000000000"
);
This endpoint is currently under construction. Please reach out to support if you'd like to use it.
Returns the status of a specific message request - use this to check the progress of that message.
We recommend using the message.status webhook to receive delivery status updates instead of polling this endpoint.

​
Path Params

​
messageId
string
required
The ID of the message. This is returned when you send a message.

​
Response

​
communication
Communication
required
The resulting FHIR Communication resource.
{
  "communication": {
    "resourceType": "Communication",
    "id": "00000000-0000-0000-0000-000000000000",
    "status": "in-progress",
    "subject": {
      "reference": "Patient/00000000-0000-0000-0000-000000000000"
    },
    "topic": {
      "text": "Referral - cardiology"
    },
    "sender": {
      "display": "Your Organization name"
    },
    "recipient": [
      {
        "type": "Organization",
        "display": "intake@cardio.direct.partner.com"
      },
      {
        "type": "Practitioner",
        "display": "1234567893"
      }
    ],
    "sent": "2026-06-16T18:40:00.000Z",
    "payload": [
      {
        "contentReference": {
          "reference": "DocumentReference/00000000-0000-0000-0000-000000000000"
        }
      }
    ],
    "extension": [
      {
        "url": "https://public.metriport.com/fhir/StructureDefinition/data-source.json",
        "valueCoding": {
          "system": "https://public.metriport.com/fhir/StructureDefinition/data-source.json",
          "code": "METRIPORT"
        }
      }
    ]
  }
}

import { MetriportMedicalApi } from "@metriport/api-sdk";

const metriport = new MetriportMedicalApi("YOUR_API_KEY");

const status = await metriport.getMessageStatus(
  "00000000-0000-0000-0000-000000000000"
);