Skip to content

GraphQL Overview

Download GraphQL schema

Queries

Overview

Objects

Overview

FaxInUdrQueryResult

content

List of fax reception records.

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": "FaxInUdrReportRecord" } ], "pageIndex": 40, "pageSize": 40, "hasMoreElements": true }

FaxInUdrReportRecord

Fax Inbound UDR Report Record

faxId
ID!,non-null

Unique identifier for the fax reception record.

accountingService
String

Accounting service identifier, used for billing and cost allocation.

allPages
Int

Total number of pages in the received fax document.

archivePurgeAt
String

Scheduled timestamp when archived fax data will be purged.

archivingStatus
String

Current archiving status of the fax document.

baudRate
Int

Transmission speed, in bits per second, used during fax reception.

billingCode
String

Billing code associated with the fax reception for cost allocation.

callConnectedAt
String

Timestamp when the fax call was successfully connected.

calledCountry
String

Country from which the fax was sent.

calledCsId
String

Called Station Identifier of the receiving fax machine.

calledNumber
String

Phone number that received the fax.

calledNumberDisplay
String

Display format of the called number as shown to users.

callingNumber
String

Phone number from which the fax was sent.

callingTsId
String

Transmitting Station Identifier of the sending fax machine.

callStartedAt
String

Timestamp when the fax call was initiated.

confirmedPages
Int

Number of pages successfully received and confirmed.

customerId
String

Customer identifier for the account.

deliveryRecipients
String

Email addresses or delivery endpoints for the received fax.

deliverySender
String

Sender information used in fax delivery notifications.

deliverySenderUser
String

User account associated with the delivery sender.

discardedPages
Int

Number of pages discarded due to transmission errors.

docMimeType
String

MIME type of the converted fax document (e.g., application/pdf).

documentDeliveryStatus
String

Status of document delivery to the specified recipients.

faxFileSize
Int

Size of the received fax file, in bytes.

faxTransmitStatus
String

Transmission status indicating success or failure of fax reception.

keyTimestamp
String

Primary timestamp used for record sorting and filtering.

recipientsCount
Int

Number of recipients configured to receive the fax document.

resolution
String

Fax resolution quality (e.g., standard, fine, superfine).

secondaryDeliveryRecipients
String

Additional email addresses for secondary delivery of the fax.

virtualPagesBilled
Int

Number of virtual pages billed for this fax reception.

Sample
{ "faxId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "accountingService": "Example String", "allPages": 40, "archivePurgeAt": "Example String", "archivingStatus": "Example String", "baudRate": 40, "billingCode": "Example String", "callConnectedAt": "Example String", "calledCountry": "Example String", "calledCsId": "Example String", "calledNumber": "Example String", "calledNumberDisplay": "Example String", "callingNumber": "Example String", "callingTsId": "Example String", "callStartedAt": "Example String", "confirmedPages": 40, "customerId": "Example String", "deliveryRecipients": "Example String", "deliverySender": "Example String", "deliverySenderUser": "Example String", "discardedPages": 40, "docMimeType": "Example String", "documentDeliveryStatus": "Example String", "faxFileSize": 40, "faxTransmitStatus": "Example String", "keyTimestamp": "Example String", "recipientsCount": 40, "resolution": "Example String", "secondaryDeliveryRecipients": "Example String", "virtualPagesBilled": 40 }

FaxOutUdrQueryResult

List of fax outbound usage detail records.

pageIndex
Int

Page index of the response, starting at 0.

pageSize
Int

Page size of the response.

hasMoreElements
Boolean

Indicates whether there are more pages.

Implements interfaces

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

FaxOutUdrReportRecord

Fax Outbound UDR Report Record

faxId
ID!,non-null

Unique identifier for the fax transmission.

jobId
String

Job identifier used for grouping related fax operations.

accountId
String

Account identifier associated with the fax transmission.

accountName
String

Account name associated with the fax transmission.

accountServerId
String

Server identifier for the account.

accountService
String

Service type for the account.

attemptPages
Int

Number of pages in the transmission attempt.

attemptSeqNo
Int

Sequence number of the transmission attempt.

baudRate
Int

Transmission speed in bits per second.

billedCountry
String

Country billed for the fax transmission.

callConnectedAt
String

Timestamp when the call was connected.

callDuration

Duration of the call, in milliseconds.

calledCountry
String

Country of the called number.

calledCsId
String

Called Station Identifier (CSI) of the receiving fax machine.

calledNumber
String

Phone number that was called.

calledZone
Int

Zone classification for the called number.

callEndedAt
String

Timestamp when the call ended.

callingTsId
String

Transmitting Station Identifier (TSI) of the sending fax machine.

callInviteAt
String

Timestamp when the call was initiated.

docPages
Int

Number of pages in the document.

faxCustomerRef
String

Customer reference for the fax transmission.

jobArchivePurgeAt
String

Scheduled timestamp for job archive purge.

jobBillingCode
String

Billing code for the job.

jobBillingInfo
String

Billing information for the job.

jobCustomerId
String

Customer identifier for the job.

jobCustomerRef
String

Customer reference for the job.

jobCustomerResolution
String

Resolution setting specified by the customer.

jobCustomerStartFaxAt
String

Customer-specified start time for the fax transmission.

jobCustomerTags
String

Customer tags associated with the job.

jobExpress
Boolean

Indicates whether express delivery was requested.

jobPersonalized
Boolean

Indicates whether personalized features were enabled.

jobSubmissionDc
String

Data center where the job was submitted.

jobSubmittedAt
String

Timestamp when the job was submitted.

keyTimestamp
String

Key timestamp for the record.

lastAttemptEndedAt
String

Timestamp when the last attempt ended.

lastAttemptSeqNo
Int

Sequence number of the last attempt.

maxPageTransmitted
Int

Maximum page number transmitted.

processingFinalAt
String

Timestamp when final processing completed.

statusCode
String

Status code for the transmission.

statusName
String

Status name for the transmission.

statusReason
String

Reason for the transmission status.

sumCallDurations

Total duration of all call attempts, in milliseconds.

sumPagesTransmitted
Int

Total number of pages transmitted across all attempts.

timeToFirstDial
Int

Time from job submission to first dial attempt, in seconds.

virtualPagesBilled
Int

Number of virtual pages billed.

Sample
{ "faxId": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "jobId": "Example String", "accountId": "Example String", "accountName": "Example String", "accountServerId": "Example String", "accountService": "Example String", "attemptPages": 40, "attemptSeqNo": 40, "baudRate": 40, "billedCountry": "Example String", "callConnectedAt": "Example String", "callDuration": "Example Custom Scalar", "calledCountry": "Example String", "calledCsId": "Example String", "calledNumber": "Example String", "calledZone": 40, "callEndedAt": "Example String", "callingTsId": "Example String", "callInviteAt": "Example String", "docPages": 40, "faxCustomerRef": "Example String", "jobArchivePurgeAt": "Example String", "jobBillingCode": "Example String", "jobBillingInfo": "Example String", "jobCustomerId": "Example String", "jobCustomerRef": "Example String", "jobCustomerResolution": "Example String", "jobCustomerStartFaxAt": "Example String", "jobCustomerTags": "Example String", "jobExpress": true, "jobPersonalized": true, "jobSubmissionDc": "Example String", "jobSubmittedAt": "Example String", "keyTimestamp": "Example String", "lastAttemptEndedAt": "Example String", "lastAttemptSeqNo": 40, "maxPageTransmitted": 40, "processingFinalAt": "Example String", "statusCode": "Example String", "statusName": "Example String", "statusReason": "Example String", "sumCallDurations": "Example Custom Scalar", "sumPagesTransmitted": 40, "timeToFirstDial": 40, "virtualPagesBilled": 40 }

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