Skip to main content
POST
/
ims
/
equipment
/
switch-request
Submit railcar switch request
curl --request POST \
  --url https://api-lg.arms.cedarai.com/ims/equipment/switch-request \
  --header 'Content-Type: application/json' \
  --header 'x-arms-api-key: <api-key>' \
  --header 'x-arms-assume-user: <api-key>' \
  --data '
{
  "carrierId": 111111,
  "switchRequests": [
    {
      "equipmentId": 1,
      "trackId": 2,
      "spot": "AD2",
      "requestType": "PL"
    }
  ]
}
'
{
  "equipment": [
    {
      "resourceType": "Equipment",
      "resourceId": 123,
      "uuid": "<string>",
      "equipmentInitial": "<string>",
      "equipmentNumber": 123,
      "aarCarType": "<string>",
      "equipmentType": "CAR",
      "descriptionCode": "<string>",
      "arrivalState": "INBOUND",
      "parentGroupings": [
        {
          "resourceType": "Grouping",
          "resourceId": 123,
          "uuid": "<string>",
          "name": "<string>",
          "groupingType": "<string>",
          "sortOrder": 123,
          "colorToken": "<string>",
          "groupingIndex": 123
        }
      ],
      "waybill": {
        "loadStatus": "<string>",
        "commodityCode": "<string>",
        "netWeightTons": 123,
        "originCityName": "<string>",
        "originStateOrProvince": "<string>",
        "originFsac": "<string>",
        "destinationCityName": "<string>",
        "destinationStateOrProvince": "<string>",
        "destinationFsac": "<string>",
        "consignorCustomerName": "<string>",
        "consigneeCustomerName": "<string>",
        "originScac": "<string>",
        "trafficType": "LOCAL",
        "shipmentPaymentMethod": "11",
        "transportationMethod": "R",
        "shipmentId": "<string>",
        "weightUnitCode": "E",
        "shipmentQualifier": "1",
        "capacityLoadCode": "C",
        "customsDocumentationHandlingCode": "<string>",
        "confidentialBillingRequestCode": "C",
        "taxReasonCode": "<string>",
        "shipmentWeightCode": "A3",
        "referencedPatternIdentifier": "<string>",
        "billingCode": "A",
        "repetitivePatternNumber": 123,
        "extendedReferenceInfo": [
          {
            "referenceIdQualifier": "<string>",
            "referenceId": "<string>",
            "description": "<string>",
            "date": "<string>",
            "timestamp": "<string>"
          }
        ],
        "crossReferenceEquipment": [
          {
            "referenceIdQualifier": "<string>",
            "referenceId": "<string>",
            "equipmentInitial": "<string>",
            "equipmentNumber": 123,
            "crossReferenceTypeCode": "A",
            "equipmentOwnerScac": "<string>",
            "equipmentLength": "<string>",
            "equipmentOperatorScac": "<string>",
            "equipmentIsDamaged": true,
            "checkDigit": 123
          }
        ],
        "equipmentDetails": [
          {
            "equipmentInitial": "<string>",
            "equipmentNumber": 123,
            "netWeightLbs": 123,
            "grossWeightLbs": 123,
            "weightType": "ESTIMATED",
            "tareWeightLbs": 123,
            "weightAllowance": 123,
            "dunnage": 123,
            "ownershipCode": "L",
            "descriptionCode": "<string>",
            "owningCarrierCode": "<string>",
            "position": "<string>",
            "lengthIn": 123,
            "tareQualifierCode": "A",
            "checkDigit": 123,
            "heightIn": 123,
            "widthIn": 123,
            "isoContainerCode": "<string>",
            "carrierCode": "<string>",
            "aarCarType": "<string>",
            "chassisInitial": "<string>",
            "chassisNumber": 123
          }
        ],
        "intermodalStatusDetails": {
          "shipmentStatusCode": "A",
          "shipmentStatusTime": "<string>"
        },
        "specialHandlingCodes": [
          "<string>"
        ],
        "protectiveService": [
          {
            "ruleCode": "<string>",
            "serviceCode": "D",
            "temperatureUnit": "CE",
            "optimalTemperature": 123,
            "scac": "<string>",
            "fsac": "<string>",
            "cityName": "<string>",
            "stateOrProvince": "<string>",
            "precooled": true,
            "heaterLocation": "Y",
            "commodityType": "Y",
            "doorwaySpace": "Y",
            "originTemperature": 123
          }
        ],
        "originStation": {
          "fsac": "<string>",
          "cityName": "<string>",
          "stateOrProvince": "<string>",
          "postalCode": "<string>",
          "countryCode": "<string>",
          "splc": "<string>"
        },
        "originJunction": {
          "fsac": "<string>",
          "cityName": "<string>",
          "stateOrProvince": "<string>",
          "postalCode": "<string>",
          "countryCode": "<string>",
          "splc": "<string>"
        },
        "destinationStation": {
          "fsac": "<string>",
          "cityName": "<string>",
          "stateOrProvince": "<string>",
          "postalCode": "<string>",
          "countryCode": "<string>",
          "splc": "<string>"
        },
        "destinationJunction": {
          "fsac": "<string>",
          "cityName": "<string>",
          "stateOrProvince": "<string>",
          "postalCode": "<string>",
          "countryCode": "<string>",
          "splc": "<string>"
        },
        "parties": [
          {
            "partyType": "11",
            "name": "<string>",
            "idCodeQualifier": "1",
            "idCode": "<string>",
            "entitySubIdentifierRelationshipCode": "<string>",
            "entitySubIdentifierCode": "<string>",
            "additionalNames": [
              "<string>"
            ],
            "address": [
              "<string>"
            ],
            "cityName": "<string>",
            "stateOrProvince": "<string>",
            "postalCode": "<string>",
            "countryCode": "<string>",
            "locationQualifier": "<string>",
            "locationIdentifier": "<string>",
            "countrySubdivisionCode": "<string>",
            "administrativeContacts": [
              {
                "contactFunctionCode": "<string>",
                "name": "<string>",
                "communicationNumbers": [
                  {
                    "qualifier": "<string>",
                    "number": "<string>"
                  }
                ],
                "contactInquiryReference": "<string>"
              }
            ],
            "billingInfo": [
              {
                "rebillReasonCode": "RC",
                "origin": {
                  "fsac": "<string>",
                  "cityName": "<string>",
                  "stateOrProvince": "<string>",
                  "postalCode": "<string>",
                  "countryCode": "<string>",
                  "splc": "<string>"
                },
                "destination": {
                  "fsac": "<string>",
                  "cityName": "<string>",
                  "stateOrProvince": "<string>",
                  "postalCode": "<string>",
                  "countryCode": "<string>",
                  "splc": "<string>"
                },
                "carrierCodes": [
                  "<string>"
                ]
              }
            ],
            "referenceInfo": [
              {
                "referenceIdQualifier": "<string>",
                "referenceId": "<string>",
                "description": "<string>"
              }
            ]
          }
        ],
        "route": [
          {
            "carrierCode": "<string>",
            "junctionCode": "<string>",
            "routingSequenceCode": "1",
            "splc": "<string>",
            "intermodalServiceCode": "<string>",
            "additionalSwitchCarrierCodes": [
              "<string>"
            ]
          }
        ],
        "emptyCarDispositions": [
          {
            "destinationConsigneeName": "<string>",
            "destinationConsigneeIdQualifier": "<string>",
            "destinationConsigneeId": "<string>",
            "destinationCityName": "<string>",
            "destinationStateOrProvince": "<string>",
            "destinationPostalCode": "<string>",
            "destinationCountryCode": "<string>",
            "destinationAddress": "<string>",
            "destinationRoute": [
              {
                "carrierCode": "<string>",
                "junctionCode": "<string>",
                "routingSequenceCode": "1",
                "splc": "<string>",
                "intermodalServiceCode": "<string>",
                "additionalSwitchCarrierCodes": [
                  "<string>"
                ]
              }
            ]
          }
        ],
        "lineItems": [
          {
            "number": 123,
            "descriptions": [
              {
                "ladingDescription": "<string>",
                "commodityCode": "<string>",
                "commodityCodeQualifier": "3",
                "packagingCode": "<string>",
                "marksAndNumbers": "<string>",
                "marksAndNumbersQualifier": "<string>",
                "hazmatRatingCommodityCodeQualifier": "<string>",
                "hazmatRatingCommodityCode": "<string>",
                "compartmentIdCode": "<string>"
              }
            ],
            "quantity": {
              "billedAsQuantity": 123,
              "billedAsQualifier": "DM",
              "weight": 123,
              "weightQualifier": "A3",
              "volume": 123,
              "volumeUnitQualifier": "B",
              "ladingQuantity": 123,
              "packagingFormCode": "<string>",
              "dunnageDescription": "<string>",
              "weightUnitCode": "<string>",
              "typeOfServiceCode": "<string>"
            },
            "measurements": [
              {
                "measurementReferenceIdCode": "<string>",
                "measurementQualifier": "<string>",
                "measurementValue": 123,
                "unitCode": "1E",
                "rangeMinimum": 123,
                "rangeMaximum": 123,
                "measurementSignificanceCode": "<string>",
                "measurementAttributeCode": "<string>",
                "surfaceLayerPositionCode": "<string>",
                "measurementMethodOrDevice": "<string>",
                "codeListQualifier": "<string>",
                "industryCode": "<string>"
              }
            ],
            "priceAuthorities": [
              {
                "referenceIdQualifier": "<string>",
                "referenceId": "<string>",
                "primaryPublicationAuthority": "<string>",
                "regulatoryAgencyCode": "<string>",
                "tariffAgencyCode": "<string>",
                "issuingCarrierIdentifier": "<string>",
                "suffix": "<string>",
                "itemNumber": "<string>",
                "supplementIdentifier": "<string>",
                "sectionNumber": "<string>",
                "itemNumberSuffix": "<string>",
                "effectiveDate": "<string>",
                "expirationDate": "<string>"
              }
            ]
          }
        ],
        "hazardousInfo": [
          {
            "ladingUnitCode": "<unknown>",
            "ladingQuantity": 123,
            "unIdCode": "<string>",
            "unPageNumber": "<string>",
            "commodityCode": "<string>",
            "unitCode": "<unknown>",
            "quantity": 123,
            "compartmentIdCode": "<string>",
            "residueIndicatorCode": "<string>",
            "packagingGroupCode": "<string>",
            "interimHazmatRegulatoryNumber": "<string>",
            "industryCode": "<string>",
            "classificationInfo": [
              {
                "hazardousClass": "<string>",
                "hazardousClassQualifier": "P",
                "hazardousPlacardNotation": "<string>",
                "hazardousEndorsement": "<string>",
                "reportableQuantityCode": "RQ",
                "flashpointUnitCode": "<unknown>",
                "flashpointTemperature": 123,
                "controlUnitCode": "<unknown>",
                "controlTemperature": 123,
                "emergencyUnitCode": "<unknown>",
                "emergencyTemperature": 123,
                "netExplosiveWeightUnitCode": "<string>",
                "netExplosiveWeight": 123
              }
            ],
            "hazmatShippingNameInfo": [
              {
                "hazmatShippingName": "<string>",
                "hazmatShippingNameQualifier": "C",
                "nosIndicatorCode": "<string>",
                "railSafetySensitiveMaterial": true
              }
            ],
            "hazmatAdditionalInfo": [
              {
                "hazmatShippingInfoQualifier": "ADI",
                "hazmatShippingInfo": "<string>",
                "hazmatShippingInfoOverflow": "<string>",
                "hazardZoneCode": "<string>",
                "radioactiveActivityUnitCode": "1T",
                "radioactiveActivity": 123,
                "radioactiveTransportIndex": 123,
                "fumigationDate": "<string>"
              }
            ],
            "epaRequiredData": [
              {
                "epaWasteStreamNumberCode": "<string>",
                "wasteCharacteristicsCode": "<string>",
                "hazardousWasteNumberStateOrProvince": "<string>",
                "hazardousWasteNumber": "<string>"
              }
            ],
            "canadianDangerousRequirements": [
              {
                "emergencyResponsePlanNumber": "<string>",
                "communicationNumber": "<string>",
                "packagingGroupCode": "<string>",
                "firstSubsidiaryClassification": "<string>",
                "secondSubsidiaryClassification": "<string>",
                "thirdSubsidiaryClassification": "<string>",
                "subsidiaryRiskIndicator": "<string>",
                "netExplosiveQuantity": 123,
                "canadianHazardousNotation": "<string>",
                "specialCommodityIndicatorCode": "<string>",
                "additionalCommunicationNumber": "<string>",
                "netExplosiveQuantityUnitCode": "<unknown>",
                "hazmatShipmentInfoQualifier": "<string>",
                "hazmatQuantity": 123,
                "hazmatQuantityUnitCode": "<unknown>"
              }
            ],
            "transborderHazardousRequirements": [
              {
                "hazardousClassification": "<string>",
                "hazardousPlacardNotation": "<string>",
                "hazardousEndorsement": "<string>"
              }
            ],
            "hazmatReferenceNumbers": [
              {
                "referenceIdQualifier": "<string>",
                "referenceId": "<string>",
                "date": "<string>"
              }
            ],
            "administrativeContacts": [
              {
                "contactFunctionCode": "<string>",
                "name": "<string>",
                "communicationNumbers": [
                  {
                    "qualifier": "<string>",
                    "number": "<string>"
                  }
                ],
                "contactInquiryReference": "<string>"
              }
            ],
            "parties": [
              {
                "partyType": "11",
                "name": "<string>",
                "idCodeQualifier": "1",
                "idCode": "<string>",
                "entitySubIdentifierRelationshipCode": "<string>",
                "entitySubIdentifierCode": "<string>",
                "additionalNames": [
                  "<string>"
                ],
                "address": [
                  "<string>"
                ],
                "cityName": "<string>",
                "stateOrProvince": "<string>",
                "postalCode": "<string>",
                "countryCode": "<string>",
                "locationQualifier": "<string>",
                "locationIdentifier": "<string>",
                "countrySubdivisionCode": "<string>",
                "administrativeContacts": [
                  {
                    "contactFunctionCode": "<string>",
                    "name": "<string>",
                    "communicationNumbers": [
                      {
                        "qualifier": "<string>",
                        "number": "<string>"
                      }
                    ],
                    "contactInquiryReference": "<string>"
                  }
                ],
                "billingInfo": [
                  {
                    "rebillReasonCode": "RC",
                    "origin": {
                      "fsac": "<string>",
                      "cityName": "<string>",
                      "stateOrProvince": "<string>",
                      "postalCode": "<string>",
                      "countryCode": "<string>",
                      "splc": "<string>"
                    },
                    "destination": {
                      "fsac": "<string>",
                      "cityName": "<string>",
                      "stateOrProvince": "<string>",
                      "postalCode": "<string>",
                      "countryCode": "<string>",
                      "splc": "<string>"
                    },
                    "carrierCodes": [
                      "<string>"
                    ]
                  }
                ],
                "referenceInfo": [
                  {
                    "referenceIdQualifier": "<string>",
                    "referenceId": "<string>",
                    "description": "<string>"
                  }
                ]
              }
            ]
          }
        ],
        "hazardousCertifications": [
          {
            "name": "<string>"
          }
        ],
        "release": {
          "releaseCode": "B",
          "releaseDate": "<string>",
          "releaseTime": "<string>"
        },
        "defaultReceiver": "<string>",
        "waybillTemplateId": 123,
        "waybillTemplateName": "<string>",
        "waybillNumberSuffix": "<string>",
        "originCarrierCode": "<string>",
        "consigneeLocationId": 123,
        "shipperLocationId": 123,
        "inCareOfLocationId": 123,
        "freightBillPartyLocationId": 123,
        "pickupPartyLocationId": 123,
        "waybillNumber": 123,
        "waybillDate": "<string>",
        "billOfLadingNumber": "<string>",
        "originSystem": "ARMS",
        "preparationDate": "<string>",
        "preparationTime": "<string>",
        "revisionNumber": 123,
        "revisionTime": "<string>",
        "revisionSourceType": "WAYBILL",
        "armsTrackingId": "<string>",
        "resourceType": "Waybill",
        "resourceId": 123,
        "uuid": "<string>",
        "waybillStatus": "PENDING",
        "createdAt": "<string>"
      },
      "umler": {
        "equipmentInitial": "<string>",
        "equipmentNumber": 123,
        "car": "<string>",
        "mechanicalDesignation": "<string>",
        "owner": "<string>",
        "elementEquipmentGroup": "<string>",
        "lessee": "<string>",
        "markOwnerCategory": "<string>",
        "outsideLength": 123,
        "outsideLengthFt": 123,
        "isIntl": true,
        "grossRailWeight": 123,
        "grossRailWeightUnit": "IN",
        "grossRailWeightLb": 123,
        "loadLimit": 123,
        "cubicFeetCapacity": 123,
        "tareWeight": 123,
        "tareWeightUnit": "IN",
        "tareWeightLb": 123,
        "plateCode": "<string>",
        "insideLength": 123,
        "insideLengthUnit": "IN",
        "insideLengthFt": 123,
        "insideHeight": 123,
        "insideHeightUnit": "IN",
        "insideHeightFt": 123,
        "outsideExtremeWidth": 123,
        "outsideExtremeWidthUnit": "IN",
        "outsideExtremeWidthFt": 123,
        "outerExtremeHeight": 123,
        "outerExtremeHeightUnit": "IN",
        "outerExtremeHeightFt": 123,
        "outsideHeightExtremeWidth": 123,
        "outsideHeightExtremeWidthUnit": "IN",
        "outsideHeightExtremeWidthFt": 123,
        "sideDoorType": "<string>",
        "sideDoorHeight": 123,
        "sideDoorHeightUnit": "IN",
        "sideDoorHeightFt": 123,
        "sideDoorWidth": 123,
        "sideDoorWidthUnit": "IN",
        "sideDoorWidthFt": 123,
        "boxSideDoorOrientation": "<string>",
        "axleCount": 123,
        "brakeShoeType": "<string>",
        "bodyMaterial": "<string>",
        "operatingBrakes": 123,
        "floorStrengthClassification": "<string>",
        "poolNumber": "<string>",
        "endOfTrainOnly": "<string>",
        "shoveCarToRest": "<string>",
        "shoveAdjCarToRest": "<string>",
        "trainPositionSensitive": "<string>",
        "couplerStyle": "<string>",
        "unitEquipmentGroup": "<string>",
        "abtDueDate": "<string>",
        "carGrade": "<string>",
        "lengthFt": 123,
        "brakeWeightLb": 123,
        "netWeightLb": 123,
        "allowedSpeed": "<string>",
        "regionCode": "<string>"
      },
      "notes": "<string>",
      "intermodalUnits": [
        {
          "resourceType": "IntermodalUnit",
          "resourceId": 123,
          "uuid": "<string>"
        }
      ],
      "loadStatus": "LOAD",
      "ichrTime": "2023-11-07T05:31:56Z",
      "workOrder": {
        "resourceId": 123,
        "uuid": "<string>",
        "workOrderId": "<string>",
        "status": "PENDING",
        "trainId": "<string>",
        "inTransit": true,
        "lastEventId": 123,
        "hasBeenDeparted": true
      },
      "workOrders": [
        {
          "resourceId": 123,
          "uuid": "<string>",
          "workOrderId": "<string>",
          "status": "PENDING",
          "trainId": "<string>",
          "inTransit": true,
          "lastEventId": 123,
          "hasBeenDeparted": true
        }
      ]
    }
  ]
}

Authorizations

x-arms-api-key
string
header
required

Your ARMS API key

x-arms-assume-user
string
header
required

Email of a user assigned to the appropriate user group

Query Parameters

carrierId
integer
required

Carrier identifier; required for all endpoints

viewAsUserGroup
string

Optional user group context

Body

application/json
carrierId
integer
required

Carrier identifier for the requests.

switchRequests
object[]
required

One or more switch requests to submit.

Response

OK

equipment
object[]