API Docs
YMS API
Data Models
Appointment
Appointment View

AppointmentView

{
  "id": 0,
  "appointmentId": "string",
  "appointmentType": "INBOUND",
  "carrierId": "string",
  "carrierName": "string",
  "finalCarrierId": "string",
  "subCarrierName": "string",
  "appointmentTime": "string",
  "appointmentStatus": "NEW",
  "customerIds": [
    "string"
  ],
  "externalId": 0,
  "entryId": "string",
  "referenceCode": "string",
  "driverId": "string",
  "createdTime": "string",
  "createdBy": "string",
  "updatedTime": "string",
  "updatedBy": "string",
  "customerNames": [
    "string"
  ],
  "appointmentActionViews": [
    {
      "id": 0,
      "appointmentId": "string",
      "appointmentType": "INBOUND",
      "serviceType": "string",
      "appointmentTime": "string",
      "referenceIds": [
        "string"
      ],
      "createdTime": "string",
      "createdBy": "string",
      "updatedTime": "string",
      "updatedBy": "string",
      "loadViews": [
        {
          "id": "string",
          "loadId": "LOAD-12345",
          "loadStatus": "string",
          "loadNo": "string",
          "shipMethod": "string",
          "carrierId": "string",
          "appointmentTime": "2025-08-08T10:00:00",
          "appointmentId": "string",
          "orderIds": [
            "string"
          ],
          "customerId": "string",
          "masterBol": "string",
          "sealNo": "123456",
          "customerName": "string",
          "carrierName": "string",
          "orderViews": [
            {}
          ],
          "dynamicFieldValues": [
            {}
          ],
          "equipmentType": "TRAILER",
          "equipmentNo": "string",
          "referenceNoList": [
            "string"
          ],
          "poNoList": [
            "string"
          ],
          "templateLoadKey": "string",
          "proNos": [
            "string"
          ],
          "invoicePros": [
            "string"
          ],
          "doNos": [
            "string"
          ],
          "tripNos": [
            "string"
          ],
          "loadType": "string",
          "stagingLocationName": "string",
          "shippedTime": "string"
        }
      ],
      "receiptViews": [
        {
          "id": 0,
          "receiptId": "string",
          "receiptStatus": "string",
          "receiptType": "string",
          "poNo": "string",
          "carrierId": "string",
          "customerId": "string",
          "referenceNo": "string",
          "equipmentType": "string",
          "equipmentNo": "string",
          "totalPalletQty": 0,
          "itemLines": [
            {}
          ],
          "appointmentTime": "string",
          "appointmentId": "string",
          "sealNo": "string",
          "dataChannel": "YMS",
          "eventTime": "string",
          "extraData": "string",
          "carrierName": "string",
          "customerName": "string",
          "dynamicFieldValues": [
            {}
          ],
          "proNos": [
            "string"
          ],
          "invoicePros": [
            "string"
          ],
          "doNos": [
            "string"
          ],
          "tripNo": "string"
        }
      ]
    }
  ],
  "driverSnapshot": "string",
  "driverSnapshotParse": {
    "driverId": "string",
    "firstName": "string",
    "middleName": "string",
    "lastName": "string",
    "driverPhone": "string",
    "phone": "string",
    "licenseNumber": "string",
    "licenseExpirationDate": "string",
    "licenseState": "string",
    "email": "string",
    "licensePlate": "ABC123",
    "carrierName": "string",
    "carrierId": "string",
    "usdot": "string",
    "equipmentNo": "string",
    "equipmentType": "VEHICLE",
    "cargoStatus": "UNKNOWN"
  },
  "serviceTypes": [
    "string"
  ],
  "checkedInTime": "string",
  "carrierFinishTime": "string",
  "driverFinishTime": "string",
  "finalCarrierView": {
    "carrierId": "string",
    "carrierName": "string",
    "scac": [
      "string"
    ],
    "usdot": "string",
    "mcNumber": "string",
    "verified": true,
    "createdTime": "string",
    "createdBy": "string",
    "updatedTime": "string",
    "updatedBy": "string",
    "carrierStatus": "ACTIVE,INACTIVE,EXCEPTION",
    "knownName": "string",
    "orgIds": [
      "string"
    ]
  },
  "cargoStatus": "UNKNOWN",
  "notes": "string"
}
 

Properties

NameTypeRequiredConstraintsChinese NameDescription
idinteger(int64)falsenoneInternal database ID
appointmentIdstringfalsenoneUnique appointment identifier
appointmentTypestringfalsenoneType of appointment
carrierIdstringfalsenoneCarrier identifier
carrierNamestringfalsenoneCarrier name
finalCarrierIdstringfalsenoneSub-carrier identifier
subCarrierNamestringfalsenoneSub-carrier name
appointmentTimestringfalsenoneScheduled appointment time
appointmentStatusstringfalsenoneCurrent appointment status
customerIds[string]falsenoneList of customer identifiers
externalIdinteger(int64)falsenoneExternal system identifier
entryIdstringfalsenoneEntry ticket identifier
referenceCodestringfalsenone6-digit reference code for check-in binding
driverIdstringfalsenoneDriver identifier
createdTimestringfalsenoneRecord creation timestamp
createdBystringfalsenoneUser who created the record
updatedTimestringfalsenoneRecord last update timestamp
updatedBystringfalsenoneUser who last updated the record
customerNames[string]falsenoneList of customer names
appointmentActionViews[AppointmentActionView (opens in a new tab)]falsenoneList of appointment action views
driverSnapshotstringfalsenoneDriver information snapshot
driverSnapshotParseDriverSnapshot (opens in a new tab)falsenoneDriver information snapshot (parsed object)
serviceTypes[string]falsenoneList of service types
checkedInTimestringfalsenoneActual check-in timestamp
carrierFinishTimestringfalsenoneTime when carrier finished filling driver info and SMS was sent
driverFinishTimestringfalsenoneTime when driver finished pre check-in and QR code was generated
finalCarrierViewCarrierView (opens in a new tab)falsenoneSub-carrier detailed information
cargoStatusstringfalsenoneCargo status
notesstringfalsenoneNote or remarks for the appointment

Enum Values

PropertyValue
appointmentTypeINBOUND
appointmentTypeOUTBOUND
appointmentTypeBOTH
appointmentStatusNEW
appointmentStatusCANCELED
appointmentStatusNOT_CONFIRMED
appointmentStatusPENDING_DISPATCH
appointmentStatusWAITING_FOR_DRIVER
appointmentStatusPRE_CHECK_IN_COMPLETE
appointmentStatusCHECKED_IN
cargoStatusUNKNOWN
cargoStatusFULL
cargoStatusEMPTY
cargoStatusFULL_AFTER_LOADED
cargoStatusEMPTY_AFTER_OFFLOAD