S
Samva
S
Samva
DashboardAPISamva DocumentationQuickstart GuideAuthentication

API Reference

Email Management

Add Email BlockCheck if BlockedGet Email Block LogsList Email BlocksRemove Email BlockUpdate Email BlockDisable Catch-AllEnable Catch-AllGet Catch-All ConfigGet Catch-All StatsUpdate Catch-All ConfigAdd Email DomainCheck Domain VerificationEnable Email ReceivingGet Email Domain StatusList Email DomainsRemove Email DomainVerify Email DomainGet Forwarding LogCreate Forwarding RuleDelete Forwarding RuleList Forwarding RulesUpdate Forwarding RuleGet EmailGet Email StatsSend EmailAdd Email SenderCheck Sender VerificationList Email SendersRemove Email SenderCreate Email TemplateList Email TemplatesGet Email ThreadGet Thread MetadataGet Email Thread by IDGet Thread CountsGet Thread MessagesList Email Threads

Conversation Management

Configuration

Analytics & Operations

OpenAPI Specification
API ReferenceEmail

Get Email

GET
/email/messages/:messageId

Authorization

apiKey
X-API-Key<token>

API key for authentication

In: header

Query Parameters

messageId*string
Formatuuid
includeS3Urls?boolean

Include presigned S3 URLs for content (raw MIME, HTML, text)

Defaultfalse
urlExpiresIn?integer

Expiration time for S3 URLs in seconds (default: 3600 = 1 hour)

Default3600
Range60 <= value <= 3600

Response Body

application/json

curl -X GET "https://samva.app/api/v1/email/messages/:messageId?messageId=497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "organizationId": "7bc05553-4b68-44e8-b7bc-37be63c6d9e9",
  "conversationId": "ee6e55e8-45fe-4a3e-9bc8-4669f9fdf77a",
  "status": "pending",
  "channel": "sms",
  "direction": "outbound",
  "subject": "string",
  "fromEmail": "user@example.com",
  "fromName": "string",
  "toEmails": [
    {
      "email": "string",
      "name": "string"
    }
  ],
  "ccEmails": [
    {
      "email": "string",
      "name": "string"
    }
  ],
  "bccEmails": [
    {
      "email": "string",
      "name": "string"
    }
  ],
  "replyToEmail": "user@example.com",
  "messageIdHeader": "string",
  "inReplyTo": "string",
  "references": [
    "string"
  ],
  "threadPosition": 0,
  "newContent": "string",
  "quotedContent": "string",
  "hasQuotedContent": true,
  "dkimVerdict": "pass",
  "spfVerdict": "pass",
  "dmarcVerdict": "pass",
  "isAutoReply": true,
  "autoReplyReason": "out-of-office",
  "listUnsubscribeUrl": "string",
  "listUnsubscribeEmail": "string",
  "priority": "high",
  "parsingErrors": [
    "string"
  ],
  "parsingDuration": 0,
  "hasAttachments": true,
  "attachmentCount": 0,
  "attachments": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "filename": "string",
      "contentType": "string",
      "size": 0,
      "isInline": true,
      "contentId": "string"
    }
  ],
  "s3ContentUrls": {
    "rawMime": "http://example.com",
    "html": "http://example.com",
    "text": "http://example.com",
    "expiresAt": "2019-08-24T14:15:22Z"
  },
  "providerMessageId": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "receivedAt": "2019-08-24T14:15:22Z",
  "processedAt": "2019-08-24T14:15:22Z"
}

Update Forwarding Rule

Previous Page

Get Email Stats

Next Page

curl -X GET "https://samva.app/api/v1/email/messages/:messageId?messageId=497f6eca-6276-4993-bfeb-53cbbbba6f08"