Skip to content

GraphQL Overview

Download GraphQL schema

Queries

Overview

Objects

Overview

SmsInUdrReportRecord

SMS Inbound UDR report record

smsId
ID!,non-null

Unique identifier for the SMS record.

correlatedJobId
String

Identifier of the correlated job.

correlatedTrackingId
String

Correlated tracking identifier.

trackingId
String

Tracking identifier.

correlatedSmsId
String

Correlated SMS identifier.

dataCenter
String

Data center.

customerId
String

Customer identifier.

correlatedService
String

Correlated service.

correlatedServiceAccount
String

Correlated service account.

billingCode
String

Billing code provided in the job.

encoding
String

Encoding of the SMS.

sender
String

Sender phone number of the SMS.

recipient
String

Recipient phone number.

senderCountryCodeIso3
String

Recipient country iso3-code.

recipientCountryCodeIso3
String

Recipient country iso3-code.

keyword
String

Keyword associated with the SMS.

numberOfParts
Int

Number of SMS parts.

plaintextActions
String

Comma-separated list of actions in plaintext.

messageContent
String

Message-content of the SMS.

receivedTs
String

Timestamp when the SMS was received. This is the timestamp used in the query filter.

Sample
{ "smsId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "correlatedJobId": "Example String", "correlatedTrackingId": "Example String", "trackingId": "Example String", "correlatedSmsId": "Example String", "dataCenter": "Example String", "customerId": "Example String", "correlatedService": "Example String", "correlatedServiceAccount": "Example String", "billingCode": "Example String", "encoding": "Example String", "sender": "Example String", "recipient": "Example String", "senderCountryCodeIso3": "Example String", "recipientCountryCodeIso3": "Example String", "keyword": "Example String", "numberOfParts": 40, "plaintextActions": "Example String", "messageContent": "Example String", "receivedTs": "Example String" }

SmsOutUdrQueryResult

Paginated result set for SMS outbound usage detail records.

List of SMS outbound usage detail records.

pageIndex
Int

Page number of the response, starting at 0.

pageSize
Int

Page size of the response.

hasMoreElements
Boolean

Flag indicating if more pages are available.

Implements interfaces

Sample
{ "content": [ { "__typename": "SmsOutUdrReportRecord" } ], "pageIndex": 40, "pageSize": 40, "hasMoreElements": true }

SmsOutUdrReportRecord

SMS Outbound UDR report record

smsId
ID!,non-null

Unique identifier for the SMS record.

requestId
String

Request identifier.

jobId
String

Job identifier.

trackingId
String

Tracking identifier.

reference
String

Reference provided by the customer for the overall job.

recipientReference
String

Recipient reference provided by the customer for this individual recipient.

dataCenter
String

Data center.

customerId
String

Customer identifier.

service
String

Retarus service used for sending.

serviceAccount
String

Service account.

serviceVersion
String

Service version.

billingCode
String

Billing code provided in the job.

statusRequests
Boolean

Indicates whether a delivery notification was requested in the job.

flash
Boolean

Indicates whether flash SMS requests were requested in the job.

encoding
String

Encoding of the SMS.

express
Boolean

Indicates whether express delivery was requested in the job.

personalized
Boolean

Indicates whether personalized SMS was enabled.

src
String

Sender of the SMS.

recipient
String

Recipient phone number.

recipientCountryCode
String

Recipient country code.

recipientType
String

Type of the recipient, e.g., mobile or fixed line.

numberOfParts
Int

Number of SMS parts.

processStatus
String

Overall processing status of the SMS, either NULL or DONE.

statusCode
String

Current status code of the SMS.

status
String

Overall status of the SMS, either NULL or SUC_ACC.

numberScheduleTs
String

Scheduled timestamp of the SMS.

numberDeliveryTs
String

Delivery timestamp of the SMS.

numberStatusTs
String

Status timestamp of the SMS.

numberFinalTs
String

Final processing timestamp of the SMS.

deliveryProcessedTs
String

Processing timestamp of the SMS. This is the timestamp used in the query filter.

jobFinalTs
String

Job finalization timestamp for the SMS. Note: This timestamp applies to the possibly multi-SMS job, not to this individual SMS.

Sample
{ "smsId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "requestId": "Example String", "jobId": "Example String", "trackingId": "Example String", "reference": "Example String", "recipientReference": "Example String", "dataCenter": "Example String", "customerId": "Example String", "service": "Example String", "serviceAccount": "Example String", "serviceVersion": "Example String", "billingCode": "Example String", "statusRequests": true, "flash": true, "encoding": "Example String", "express": true, "personalized": true, "src": "Example String", "recipient": "Example String", "recipientCountryCode": "Example String", "recipientType": "Example String", "numberOfParts": 40, "processStatus": "Example String", "statusCode": "Example String", "status": "Example String", "numberScheduleTs": "Example String", "numberDeliveryTs": "Example String", "numberStatusTs": "Example String", "numberFinalTs": "Example String", "deliveryProcessedTs": "Example String", "jobFinalTs": "Example String" }

TransactionalEmailEventQueryResult

pageIndex
Int

Page number of the response, starting at 0.

pageSize
Int

Page size of the response.

hasMoreElements
Boolean

Flag indicating whether there are more pages.

Implements interfaces

Sample
{ "content": [ { "__typename": "TransactionalEmailEventReportRecord" } ], "pageIndex": 40, "pageSize": 40, "hasMoreElements": true }

TransactionalEmailEventReportRecord

Transactional Email Event Report Record.

eventId
ID!,non-null
dataCenter
String

Metadata: Data center where the usage occurred.

customerId
String
userId
String

Master data: Technical account (user ID).

usageId
String

Usage: Unique ID of the usage data entry.

usageMsgFrom
String

Usage: Sender address.

usageMsgFromDomain
String

Usage: Sender domain.

usageMsgTo
String

Usage: Recipient address.

usageMsgToDomain
String

Usage: Recipient domain.

costCenter
String

Master data: Cost center.

campaign
String

Usage: Campaign.

eventTime
String

Usage: Main datetime field for when the event occurred.

eventType
String

Usage: Type of event. Either 'CLICK' or 'OPEN'.

eventSubType
String

Usage: Event subtype. This can be 'LINK_CLICKED' for click event types or 'MAIL_OPENED' for mail event types.

eventClickUrl
String

Usage: For 'CLICK' events, this is the clicked URL.

eventClientName
String

Usage: Name of the user client application.

eventClientVersion
String

Usage: Version of the user client application.

eventClientIsMail
Boolean

Usage: Is the client a mail application?

eventUserAgent
String

Usage: User agent of the client application.

eventOsName
String

Usage: Operating system name.

eventOsVersion
String

Usage: Operating system version.

reference
String

Usage: Recipient reference provided by the customer.

Sample
{ "eventId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "dataCenter": "Example String", "customerId": "Example String", "userId": "Example String", "usageId": "Example String", "usageMsgFrom": "Example String", "usageMsgFromDomain": "Example String", "usageMsgTo": "Example String", "usageMsgToDomain": "Example String", "costCenter": "Example String", "campaign": "Example String", "eventTime": "Example String", "eventType": "Example String", "eventSubType": "Example String", "eventClickUrl": "Example String", "eventClientName": "Example String", "eventClientVersion": "Example String", "eventClientIsMail": true, "eventUserAgent": "Example String", "eventOsName": "Example String", "eventOsVersion": "Example String", "reference": "Example String" }

TransactionalEmailUdrQueryResult

pageIndex
Int

Page number of the response, starting at 0.

pageSize
Int

Page size of the response.

hasMoreElements
Boolean

Flag indicating whether there are more pages.

Implements interfaces

Sample
{ "content": [ { "__typename": "TransactionalEmailUdrReportRecord" } ], "pageIndex": 40, "pageSize": 40, "hasMoreElements": true }

TransactionalEmailUdrReportRecord

Transactional Email UDR Report Record

metaId
ID!,non-null
metaVersion
Int
metaCreationTime
String
customerId
String
metaEntryInterface
String

Metadata: Entry interface (e.g., SMTP or REST).

metaProcessingDomain
String
metaDataCenter
String

Metadata: Data center where the usage occurred.

metaEnvironment
String
jobId
String

Usage: Job ID.

costCenter
String

Master data: Cost center.

userId
String

Master data: Technical account (user ID).

campaign
String

Usage: Campaign.

usageId
String

Usage: Unique ID of the usage data entry.

usageType
String

Usage: Type of usage. Either 'mail' or 'traceRecover'.

usageCreationTime
String

Usage: Main datetime field for when the usage occurred.

usageMsgFrom
String

Usage: Sender address.

usageMsgFromDomain
String

Usage: Sender domain.

usageMsgTo
String

Usage: Recipient address.

usageMsgToDomain
String

Usage: Recipient domain.

usageMsgSize
Int

Usage: The size of the delivered email, in the unit specified by usageSizeUnit.

usageSizeUnit
String

Usage: The unit in which the usage size is reported.

usageStatus
String
usageSubStatus
String
usageStatusDetails
String
usageStatusCode
String
usageReference
String

Usage: Job reference provided by the customer.

usageCorrelationId
String

Usage: Recipient ID.

Sample
{ "metaId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "metaVersion": 40, "metaCreationTime": "Example String", "customerId": "Example String", "metaEntryInterface": "Example String", "metaProcessingDomain": "Example String", "metaDataCenter": "Example String", "metaEnvironment": "Example String", "jobId": "Example String", "costCenter": "Example String", "userId": "Example String", "campaign": "Example String", "usageId": "Example String", "usageType": "Example String", "usageCreationTime": "Example String", "usageMsgFrom": "Example String", "usageMsgFromDomain": "Example String", "usageMsgTo": "Example String", "usageMsgToDomain": "Example String", "usageMsgSize": 40, "usageSizeUnit": "Example String", "usageStatus": "Example String", "usageSubStatus": "Example String", "usageStatusDetails": "Example String", "usageStatusCode": "Example String", "usageReference": "Example String", "usageCorrelationId": "Example String" }

Interfaces

Overview

Enums

Overview

Inputs

Overview

Scalars

Overview