Skip to content

GraphQL Overview

Download GraphQL schema

Queries

Overview

Directives

Overview

Objects

Overview

FaxInUdrQueryResult

content

List of fax reception records.

pageIndex

Page number of the response, starting at 0.

pageSize

Page size of the response.

hasMoreElements

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

Accounting service identifier, used for billing and cost allocation.

allPages

Total number of pages in the received fax document.

archivePurgeAt

Scheduled timestamp when archived fax data will be purged.

archivingStatus

Current archiving status of the fax document.

baudRate

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

billingCode

Billing code associated with the fax reception for cost allocation.

callConnectedAt

Timestamp when the fax call was successfully connected.

calledCountry

Country from which the fax was sent.

calledCsId

Called Station Identifier of the receiving fax machine.

calledNumber

Phone number that received the fax.

calledNumberDisplay

Display format of the called number as shown to users.

callingNumber

Phone number from which the fax was sent.

callingTsId

Transmitting Station Identifier of the sending fax machine.

callStartedAt

Timestamp when the fax call was initiated.

confirmedPages

Number of pages successfully received and confirmed.

customerId

Customer identifier for the account.

deliveryRecipients

Email addresses or delivery endpoints for the received fax.

deliverySender

Sender information used in fax delivery notifications.

deliverySenderUser

User account associated with the delivery sender.

discardedPages

Number of pages discarded due to transmission errors.

docMimeType

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

documentDeliveryStatus

Status of document delivery to the specified recipients.

faxFileSize

Size of the received fax file, in bytes.

faxTransmitStatus

Transmission status indicating success or failure of fax reception.

keyTimestamp

Primary timestamp used for record sorting and filtering.

recipientsCount

Number of recipients configured to receive the fax document.

resolution

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

secondaryDeliveryRecipients

Additional email addresses for secondary delivery of the fax.

virtualPagesBilled

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

Page index of the response, starting at 0.

pageSize

Page size of the response.

hasMoreElements

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

Job identifier used for grouping related fax operations.

accountId

Account identifier associated with the fax transmission.

accountName

Account name associated with the fax transmission.

accountServerId

Server identifier for the account.

accountService

Service type for the account.

attemptPages

Number of pages in the transmission attempt.

attemptSeqNo

Sequence number of the transmission attempt.

baudRate

Transmission speed in bits per second.

billedCountry

Country billed for the fax transmission.

callConnectedAt

Timestamp when the call was connected.

callDuration

Duration of the call, in milliseconds.

calledCountry

Country of the called number.

calledCsId

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

calledNumber

Phone number that was called.

calledZone

Zone classification for the called number.

callEndedAt

Timestamp when the call ended.

callingTsId

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

callInviteAt

Timestamp when the call was initiated.

docPages

Number of pages in the document.

faxCustomerRef

Customer reference for the fax transmission.

jobArchivePurgeAt

Scheduled timestamp for job archive purge.

jobBillingCode

Billing code for the job.

jobBillingInfo

Billing information for the job.

jobCustomerId

Customer identifier for the job.

jobCustomerRef

Customer reference for the job.

jobCustomerResolution

Resolution setting specified by the customer.

jobCustomerStartFaxAt

Customer-specified start time for the fax transmission.

jobCustomerTags

Customer tags associated with the job.

jobExpress

Indicates whether express delivery was requested.

jobPersonalized

Indicates whether personalized features were enabled.

jobSubmissionDc

Data center where the job was submitted.

jobSubmittedAt

Timestamp when the job was submitted.

keyTimestamp

Key timestamp for the record.

lastAttemptEndedAt

Timestamp when the last attempt ended.

lastAttemptSeqNo

Sequence number of the last attempt.

maxPageTransmitted

Maximum page number transmitted.

processingFinalAt

Timestamp when final processing completed.

statusCode

Status code for the transmission.

statusName

Status name for the transmission.

statusReason

Reason for the transmission status.

sumCallDurations

Total duration of all call attempts, in milliseconds.

sumPagesTransmitted

Total number of pages transmitted across all attempts.

timeToFirstDial

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

virtualPagesBilled

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

Page number of the response, starting at 0.

pageSize

Page size of the response.

hasMoreElements

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

Request identifier.

jobId

Job identifier.

trackingId

Tracking identifier.

reference

Reference provided by the customer for the overall job.

recipientReference

Recipient reference provided by the customer for this individual recipient.

dataCenter

Data center.

customerId

Customer identifier.

service

Retarus service used for sending.

serviceAccount

Service account.

serviceVersion

Service version.

billingCode

Billing code provided in the job.

statusRequests

Indicates whether a delivery notification was requested in the job.

flash

Indicates whether flash SMS requests were requested in the job.

encoding

Encoding of the SMS.

express

Indicates whether express delivery was requested in the job.

personalized

Indicates whether personalized SMS was enabled.

Sender of the SMS.

recipient

Recipient phone number.

recipientCountryCode

Recipient country code.

recipientType

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

numberOfParts

Number of SMS parts.

processStatus

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

statusCode

Current status code of the SMS.

status

Overall status of the SMS, either NULL or SUC_ACC.

numberScheduleTs

Scheduled timestamp of the SMS.

numberDeliveryTs

Delivery timestamp of the SMS.

numberStatusTs

Status timestamp of the SMS.

numberFinalTs

Final processing timestamp of the SMS.

deliveryProcessedTs

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

jobFinalTs

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

Page number of the response, starting at 0.

pageSize

Page size of the response.

hasMoreElements

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

Metadata: Data center where the usage occurred.

customerId
userId

Master data: Technical account (user ID).

usageId

Usage: Unique ID of the usage data entry.

usageMsgFrom

Usage: Sender address.

usageMsgFromDomain

Usage: Sender domain.

usageMsgTo

Usage: Recipient address.

usageMsgToDomain

Usage: Recipient domain.

costCenter

Master data: Cost center.

campaign

Usage: Campaign.

eventTime

Usage: Main datetime field for when the event occurred.

eventType

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

eventSubType

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

eventClickUrl

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

eventClientName

Usage: Name of the user client application.

eventClientVersion

Usage: Version of the user client application.

eventClientIsMail

Usage: Is the client a mail application?

eventUserAgent

Usage: User agent of the client application.

eventOsName

Usage: Operating system name.

eventOsVersion

Usage: Operating system version.

reference

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

Page number of the response, starting at 0.

pageSize

Page size of the response.

hasMoreElements

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
metaCreationTime
customerId
metaEntryInterface

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

metaProcessingDomain
metaDataCenter

Metadata: Data center where the usage occurred.

metaEnvironment
jobId

Usage: Job ID.

costCenter

Master data: Cost center.

userId

Master data: Technical account (user ID).

campaign

Usage: Campaign.

usageId

Usage: Unique ID of the usage data entry.

usageType

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

usageCreationTime

Usage: Main datetime field for when the usage occurred.

usageMsgFrom

Usage: Sender address.

usageMsgFromDomain

Usage: Sender domain.

usageMsgTo

Usage: Recipient address.

usageMsgToDomain

Usage: Recipient domain.

usageMsgSize

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

usageSizeUnit

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

usageStatus
usageSubStatus
usageStatusDetails
usageStatusCode
usageReference

Usage: Job reference provided by the customer.

usageCorrelationId

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