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

ApiKeyAuth

AuthorizationstringRequired

Your ContactedAI API key. Get yours at contacted.io

Use the Authorization header with Bearer scheme: Authorization: Bearer CONTACTED_API_KEY_1234567890abcdef...

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

idstringOptional

Unique message identifier

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

statusstring · enumOptional

Current message status

Example: sentPossible values:

messagestringOptional

Human-readable status message

Example: Message delivered successfully

created_atstring · date-timeOptional

Message creation timestamp

Example: 2024-01-15T10:30:00Z

updated_atstring · date-timeOptional

Last status update timestamp

Example: 2024-01-15T10:32:15Z

sent_atstring · date-timeOptional

Message delivery timestamp (only present when status is 'sent')

Example: 2024-01-15T10:32:15Z

error_reasonstringOptional

Error description (only present when status is 'failed')

Example: Invalid recipient email address

401

Unauthorized

application/json

404

Message not found

application/json

get

/message

HTTPcURLJavaScriptPython

GET /message?id=550e8400-e29b-41d4-a716-446655440000 HTTP/1.1
Host: api.contacted.io
Authorization: Bearer YOUR_SECRET_TOKEN
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"
}