Post a Standard Load

📘

Posting a load to the load board

POST	/loadmanagement/v2/load	Creates a new load on the load board.

Authorization	bearer token
Content Type	application/json
URL Params	None
Body Params	Load Object

curl --request POST \
     --url https://api-int.truckstop.com/loadmanagement/v2/load \
     --header 'Content-Type: application/json' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <access token>' \
     --data '
{
  "postasuserID": "df7dbc1a-a21d-e911-a9ec-a3b8a698ca96",
  "equipmentAttributes": {
    "equipmentTypeId": 17,
    "equipmentOptions": [
      2
    ],
    "transportationModeId": 1,
    "otherEquipmentNeeds": "Pallet Return"
  },
  "commodityId": 1,
  "loadStops": [
    {
      "type": 1,
      "sequence": 1,
      "earlyDateTime": "2024-10-28T00:00:00Z",
      "lateDateTime": "2024-10-28T00:00:00Z",
      "location": {
        "locationName": "ABC Shippers",
        "city": "Chicago",
        "state": "IL",
        "streetAddress1": "123 Main St",
        "streetAddress2": "Null",
        "countryCode": "USA",
        "postalCode": "60007",
        "latitude": 41.8781,
        "longitude": -87.6298
      },
      "contactName": "Joseph Smith",
      "contactPhone": "1234567890",
      "stopNotes": "Pickup",
      "referenceNumbers": [
        "1"
      ]
    },
    {
      "type": 2,
      "sequence": 2,
      "earlyDateTime": "2024-10-29T11:34:32",
      "lateDateTime": "2024-10-29T11:34:32",
      "location": {
        "locationName": "CBA Warehouse",
        "city": "Chicago",
        "state": "IL",
        "streetAddress1": "123 Main St",
        "streetAddress2": "Null",
        "countryCode": "USA",
        "postalCode": "60007",
        "latitude": 41.8781,
        "longitude": -87.6298
      },
      "contactName": "Joseph Smith",
      "contactPhone": "1234567890",
      "stopNotes": "Deliver Here!",
      "referenceNumbers": [
        "2"
      ]
    }
  ],
  "note": "This is load LD1234",
  "freightClassId": 1,
  "loadNumber": "LD1234",
  "loadTrackingRequired": false,
  "rateAttributes": {
    "postedAllInRate": {
      "amount": 100.5,
      "currencyCode": "USD"
    }
  },
  "Dimensional": {
    "length": 53,
    "width": 8,
    "height": 10,
    "weight": 40000,
    "palletCount": 5,
    "pieceCount": 500,
    "cube": 4240
  },
  "LoadActionAttributes": {
    "loadActionId": "4",
    "loadActionOption": "PostOnly"
  },
  "LoadLabel": "Boxes of Screws",
  "tenderNotes": "Tender Notes",
  "loadReferenceNumbers": [
    "1"
  ]
}
'

HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
Location: https://api-int.truckstop.com/loadmanagement/v2/load?loadid=a020197d-511c-4370-aa8d-2b6172fecc4c
CorrelationId: 901b6bd9-cd5a-4fca-9955-fc94db7eeacd

{
  "loadId": "a020197d-511c-4370-aa8d-2b6172fecc4c",
  "postAsUserId": "df7dbc1a-a21d-e911-a9ec-a3b8a698ca96",
  "postAsUser": {
    "id": "df7dbc1a-a21d-e911-a9ec-a3b8a698ca96",
    "firstName": "Tom",
    "lastName": "Jerry",
    "email": "tomnjerry@truckstop.com",
    "phone": "(123)-456-7890",
    "userName": "TOMJERRY"
  },
  "createdBy": "df7dbc1a-a21d-e911-a9ec-a3b8a698ca96",
  "updatedBy": "df7dbc1a-a21d-e911-a9ec-a3b8a698ca96",
  "createdDateTime": "2019-01-10T22:6:47",
  "updatedDateTime": "2019-03-14T09:16:55",
  "loadState": {
    "loadStateDescription": "Posted",
    "loadStateId": 1
  },
  "loadStateReason": null,
  "tenderId": 0,
  "carrierName": "",
  "loadActivity": [
    {
      "id": "493c98cc-a8c5-e911-aa10-c79a7aacaffe",
      "createdDate": "2019-08-24T13:19:46Z",
      "loadState": { 
        "loadStateDescription": "Posted", 
        "loadStateId": 1 
      },
      "loadStateReason": { 
        "loadStateReasonDescription": "Not Specified", 
        "loadStateReasonId": 0 
      },
      "comment": "Test data"
    }
  ],
  "source": "Integration",
  "equipmentAttributes": {
    "equipmentTypeId": 17,
    "equipmentOptions": [
      2,
      3
    ],
    "transportationModeId": 2,
    "otherEquipmentNeeds": "Pallet return"
  },
  "commodityId": 1,
  "loadStops": [
    {
      "id": "5465e391-6ada-e911-aa11-ac4ba6accd3e",
      "type": 1,
      "sequence": 1,
      "earlyDateTime": "2019-09-18T17:09:04Z",
      "lateDateTime": "2019-09-18T17:10:04Z",
      "location": {
        "id": "bc72bac5-da02-4c08-9eda-f42b0f1c2cb3",
        "locationName": "ABC Warehouse",
        "city": "New York",
        "state": "NY",
        "streetAddress1": "261 madison ave",
        "streetAddress2": "101",
        "countryCode": "USA",
        "postalCode": "10016",
        "latitude": 40.7505,
        "longitude": -73.9806
      },
      "contactName": "Joseph Adams",
      "contactPhone": "5553125555",
      "stopNotes": "Be polite",
      "referenceNumbers": [
        "123"
      ]
    },
    {
      "id": "5665e391-6ada-e911-aa11-ac4ba6accd3e",
      "type": 2,
      "sequence": 2,
      "earlyDateTime": "2019-09-21T16:23:33",
      "lateDateTime": "2019-09-21T22:16:55",
      "location": {
        "id": "1a7667b0-1699-48ca-b8ef-75e4e5cf0b6a",
        "locationName": "XYZ Warehouse",
        "city": "Houston",
        "state": "TX",
        "streetAddress1": "1902 Westheimer Rd",
        "streetAddress2": "Suite 101",
        "countryCode": "USA",
        "postalCode": "77098",
        "latitude": 29.743,
        "longitude": -95.4075
      },
      "contactName": "Marty",
      "contactPhone": "5553325555",
      "stopNotes": "",
      "referenceNumbers": [
        "6789",
        "234hhd3"
      ]
    }
  ],
  "note": "For more details around this load please call 555-432-1026 and reference load number 39363.",
  "loadNumber": "LN_39363",
  "loadTrackingRequired": true,
  "rateAttributes": {
    "postedAllInRate": {
      "amount": 1000.53,
      "currencyCode": "USD"
    },
    "tenderAllInRate": {
      "amount": 1000.53,
      "currencyCode": "USD"
    }
  },
  "customData": [
    {
      "key": "LoadNumber",
      "value": "1234"
    },
    {
      "key": "MySpecialKey",
      "value": "MySpecialValue"
    }
  ], 
  "dimensional": {
    "length": 10.00,
    "width": 10.00,
    "weight": 3000.00,
    "height": 8.00,
    "palletCount": 0,
    "pieceCount": 1,
    "cube": 800.00
  },
  "loadActionAttributes": {
    "loadActionId": "1",
    "loadActionOption": "PostOnlineTender"
  },
  "loadLabel": "Copper Cauldron",
  "tenderNotes": "Lannister always pays his debts",
  "loadReferenceNumbers": [
    "123",
    "heth4573"
  ],
  "termsAndConditions": {
    "id": "b64f76d0-5ee1-e911-aa11-ac4ba6accd3e",
>     "name": "TC 9651"
  }
}

Post as User

📘
Notes on using the Post As User functionality

Post As User allows you to post the load on behalf of another user within the same account. The load will post with that user's contact information instead of the authenticated user's contact information.

The below endpoint provides the ability to retrieve the details of active users on the same account as the authenticated user.

Please note that the “PostAsUserId” only works for users that are on the same account, Child/Sibling/Parent accounts will not work.

If you do not use the “PostAsUserId” field, the contact information will default to the authenticated user's contact information.

POST /accountmanagement/v1/accountuser/active Retrieve active user accounts

Authorization bearer token

Content Type application/json

URL Params None

Body Params Pagination Object
curl --request POST \
     --url https://api-int.truckstop.com/accountmanagement/v1/accountuser/active \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <access token>' \
     --header 'content-type: application/json' \
     --data '
{
  "pagination": {
    "pageNumber": 1,
    "pageSize": 100
  }
}
'
{
  "pagination": {
    "totalPages": 1,
    "pageNumber": 1,
    "pageSize": 100,
    "totalItemCount": 2,
    "resultsTruncated": false
  },
  "success": true,
  "correlationId": "d8d3a649-ed29-4777-9ede-8eed72a2eb1d",
  "results": [
    {
      "success": true,
      "data": [
        {
          "userId": "005Pn000003fB93IAE",
          "accountId": "3d45735a-b155-e911-aa1e-b0e52ccc70f6",
          "id": "28bcfbd3-c1c5-97ab-5df4-ce2a084138aa",
          "emailAddress": "testUser1@truckstop.com",
          "alias": "TestUser1",
          "firstName": "Test",
          "lastName": "User1",
          "mobile": "(123) 000-0000",
          "phone": "(123) 000-0000",
          "isDefault": false,
          "isActive": true,
          "username": "testUser1@truckstop.com"
        },
        {
          "userId": "005Pn000003fB2bIAE",
          "accountId": "3d45735a-b155-e911-aa1e-b0e52ccc70f6",
          "id": "ef6fd463-653c-bfad-ea92-7d9644c1d83f",
          "emailAddress": "testUser2@truckstop.com",
          "alias": "TestUser2",
          "firstName": "Test",
          "lastName": "User2",
          "mobile": "(123) 000-0000",
          "phone": "(123) 000-0000",
          "isDefault": false,
          "isActive": true,
          "username": "testUser2@truckstop.com"
        }
      ],
      "statusSet": [
        {
          "code": 200,
          "descriptor": "OK",
          "message": "Request completed successfully",
          "field": null
        }
      ]
    }
  ]
}