Skip to main content

ENUMs Reference

These ENUMs are used across both REST and SOAP APIs. Individual endpoint and method pages link here for full definitions.


AuthLevel

User permission level. Controls what operations a user or API key may perform.

ValueDescription
NoChangeRetain the current AuthLevel — used in update operations to leave the level unchanged
RootUnrestricted system-level access (Loren Data internal only)
TechOpsTechnical operations access across all networks
NetOpsNetwork operations access
NetworkAdminFull administrative access within a single network
NetworkUserStandard user access within a network
MailboxAdminFull administrative access within a single mailbox
MailboxUserStandard user access within a mailbox
TPUserTrading partner–level access
GeneralMinimal general-purpose access

Status

Object lifecycle status. Applies to networks, mailboxes, IDs, interconnects, users, and other resources.

ValueDescription
DevelopmentObject is being configured and is not yet live
ActiveObject is live and fully operational
PreproductionObject is in a staging/testing state before going active
SuspendedObject is temporarily disabled; can be reactivated
TerminatedObject has been permanently deactivated

Direction

Message direction relative to the local mailbox.

ValueDescription
NoDirNo direction specified; used in queries that span both directions
OutBoxOutbound — messages sent from this mailbox to a trading partner
InBoxInbound — messages received by this mailbox from a trading partner

EDIStandard

EDI document standard or file format.

ValueDescription
X12ANSI ASC X12 (the primary EDI standard in North America)
EDIFACTUN/EDIFACT (international EDI standard)
TRADACOMSTRADACOMS (UK retail EDI standard)
VDAVDA (German automotive EDI standard)
XMLXML-based document
TXTPlain text file
PDFPDF document
BinaryBinary file (non-EDI payload)

ParcelStatus

Parcel delivery state. A parcel is the file-level container for one or more EDI interchanges.

ValueDescription
InBoxReadyParcel has been received and is ready for download by the recipient
InBoxTransferredParcel has been downloaded (transferred) to the recipient
InBoxArchivedParcel has been moved to archive storage after download
as2ReceiveParcel was received via an AS2 channel
as2SentParcel was delivered via an AS2 channel
ftpReceivedParcel was received via an FTP/SFTP channel
ftpSentParcel was delivered via an FTP/SFTP channel
outboxPendingParcel is queued for outbound delivery
outboxSentParcel has been sent and delivery is in progress
outboxAcknowledgedDelivery has been acknowledged by the receiving party
outboxRetryDelivery failed and the system is retrying
outboxFailedDelivery failed after all retry attempts were exhausted
outboxDeliveryErrorA delivery error was encountered (may recover)
outboxTransferredParcel has been handed off to a downstream carrier or VAN
CancelledParcel was cancelled before delivery
VaultReadyParcel is stored in the ECGrid Vault for long-term retention

RoutingGroup

ECGrid internal routing group. Determines which production cluster or environment handles the traffic.

ValueDescription
ProductionAPrimary production routing cluster A
ProductionBPrimary production routing cluster B
Migration1Migration routing group 1 (temporary, used during network migrations)
Migration2Migration routing group 2
ManagedFileTransferManaged file transfer routing path
TestTest environment routing
SuperHubSuper-hub routing for large-volume networks
Suspense1Suspense hold group 1
Suspense2Suspense hold group 2
Suspense3Suspense hold group 3
NetOpsOnly1Restricted to network operations staff only — group 1
NetOpsOnly2Restricted to network operations staff only — group 2

UseType

Designates whether an ECGrid ID or resource is for test or production use.

ValueDescription
UndefinedNo use type specified
TestTest traffic only; not used for live production EDI
ProductionLive production EDI only
TestAndProductionAccepts both test and production traffic

NetworkContactType

Contact role for a network. Used when retrieving or updating network contact information.

ValueDescription
OwnerPrimary owner of the network account
ErrorsContact for error notifications and alerts
InterconnectsContact for interconnect setup and requests
NoticesContact for general notices and announcements
ReportsContact for scheduled reports
AccountingContact for billing and accounting matters
CustomerServiceCustomer service contact

NetworkGatewayCommChannel

Communication channel type for network gateway connections.

ValueDescription
noneNo channel configured
ftpFTP (plain)
sftpSFTP (SSH File Transfer Protocol)
as2AS2 (Applicability Statement 2)
httpHTTP
oftpOFTP (Odette File Transfer Protocol)
x400X.400 messaging
gisbGISB (Gas Industry Standards Board)
rnifRosettaNet Implementation Framework
cxmlcXML (Commerce XML)
ftpsslimplicitFTP over SSL with implicit TLS
peppolPEPPOL (Pan-European Public Procurement Online)
as4AS4 (successor to AS2 for B2B messaging)
undefinedChannel type not yet defined

KeyVisibility

Visibility and sharing scope of an API key.

ValueDescription
PrivateKey is visible only to the owner
SharedKey is shared within a network or mailbox group
PublicKey is publicly visible
SessionKey is tied to a session and expires when the session ends

Objects

Object type used in audit logs, callback events, and system filtering.

ValueDescription
SystemSystem-level event
UserUser account object
NetworkNetwork object
MailboxMailbox object
ECGridIDECGrid trading partner ID
InterconnectInterconnect (partner relationship) object
MigrationMigration record (legacy; deprecated)
ParcelParcel (file container) object
InterchangeEDI interchange object
CarbonCopyCarbon copy routing rule object
CallBackEventCallback/webhook event object
AS2AS2 connection object
CommCommunications channel object
GISBGISB channel object
InterconnectNoteNote attached to an interconnect
PriceListPricing list object
ContractContract object
InvoiceInvoice object

CertificateType

Type of digital certificate used for AS2 or encryption.

ValueDescription
X509X.509 public-key certificate (most common for AS2 and TLS)
PGPPGP (Pretty Good Privacy) certificate
SSHSSH public key

CertificateUsage

Intended usage for a certificate.

ValueDescription
SSLTLS/SSL transport security
EncryptionPayload encryption
SignatureDigital signature only
EncryptionAndSignatureBoth encryption and digital signature

ReceiptType

AS2 Message Disposition Notification (MDN) receipt type.

ValueDescription
NoneNo receipt requested
SynchronousUnsignedSynchronous MDN, unsigned
SynchronousSignedSynchronous MDN, digitally signed
AsynchronousUnsignedAsynchronous MDN, unsigned
AsynchronousSignedAsynchronous MDN, digitally signed

HTTPAuthType

HTTP authentication method for callbacks and comm channel connections.

ValueDescription
NoneNo HTTP authentication
BasicHTTP Basic authentication (base64-encoded credentials)
DigestHTTP Digest authentication

StatisticsPeriod

Time period granularity for report and statistics queries.

ValueDescription
HourHourly statistics
DayDaily statistics
WeekWeekly statistics
MonthMonthly statistics

EMailSystem

Email transport system used for EDI-over-email delivery.

ValueDescription
smtpSMTP (standard internet email)
x400X.400 email messaging system

EMailPayload

How the EDI payload is attached to an email notification.

ValueDescription
BodyPayload included in the email body
AttachmentPayload included as an email attachment

CellCarrier

Mobile carrier for SMS notifications sent via the Users API.

ValueDescription
ATTCingularAT&T / Cingular Wireless
VerizonVerizon Wireless
TMobileT-Mobile
SprintPCSSprint PCS
NextelNextel
BoostMobileBoost Mobile
USCellularUS Cellular
MetroPCSMetro PCS
note

Additional carriers may be available in the live API. Check the Swagger UI at rest.ecgrid.io/swagger for the current complete list.