Email Status

Get Message Status

get

Retrieve the current status of a sent message using its ID.

SDK Examples

Node.js

const status = await contacted.getMessageStatus('550e8400-e29b-41d4-a716-446655440000');
console.log('Message status:', status.status);

Python

status = contacted.get_message_status('550e8400-e29b-41d4-a716-446655440000')
print(f"Message status: {status['status']}")

Authorizations

Query parameters

idstring · uuidRequired

The unique message ID returned from the send endpoint

Example: 550e8400-e29b-41d4-a716-446655440000

Responses

200

Message status retrieved successfully

application/json

401

Unauthorized

application/json

404

Message not found

application/json

get

HTTPcURLJavaScriptPython

GET /message HTTP/1.1
Host: api.contacted.io
Authorization: Bearer API_KEY
Accept: */*

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "message": "Message is queued for processing",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}