Skip to content

Create an equipment posting

Request

Security
OrgTokenBearer
Bodyapplication/jsonrequired
dateAvailstring, (date-time), non-emptyrequired

Equipment available date/time in ISO 8601 UTC format (e.g. 2026-07-01T00:00:00Z). Non-UTC values are coerced to UTC.

Example:"2026-07-20T08:00:00Z"
srceCitystring, [ 0 .. 50 ] charactersrequired

Source city name. Must match a known city (see city lookup) together with SrceSt.

Example:"Sarnia"
srceStstring, = 2 charactersrequired

Source state/province code (2 letters, e.g. "ON", "TX").

Example:"ON"
srceRadiusinteger, (int32), [ 50 .. 500 ]

Search radius in miles around the source city (50–500).

Example:200
destCitystring, [ 0 .. 50 ] charactersrequired

Destination city name. Must match a known city (see city lookup) together with DestSt.

Example:"Brampton"
destStstring, = 2 charactersrequired

Destination state/province code (2 letters, e.g. "ON", "TX").

Example:"ON"
destRadiusinteger, (int32), [ 50 .. 500 ]

Search radius in miles around the destination city (50–500).

Example:200
vehicleSizestring, [ 0 .. 10 ] charactersrequired

Single-letter vehicle size code — see GET /v2/reference/vehicle-sizes (e.g. "T" for TL).

Example:"T"
vehicleTypestring, [ 0 .. 50 ] characters^[VvRrKkFfSsDdTtCcUuHhLlOoNnPpIiEe]+$required

One or more single-letter vehicle type codes concatenated together — see GET /v2/reference/vehicle-types (e.g. "VR" for Van + Reefer).

Example:"VR"
contactEmailstring or null, (email)^[^@]+@[^@]+$

Contact email for this posting. Optional — defaults to your account's own email when omitted. Does not have to match the authenticated account if supplied.

Example:"dispatch@example.com"
contactPhonestring or null, [ 0 .. 15 ] characters

Contact phone for this posting. Optional — defaults to your account's own phone when omitted.

Example:null
commentstring or null, [ 0 .. 180 ] characters

Free-text comment shown alongside the posting (max 180 characters).

Example:"Reefer unit available"
postingAttribstring or null

One or more single-letter vehicle attribute codes concatenated together — see GET /v2/reference/vehicle-attributes (e.g. "AZ" for Air Ride + Hazmat).

Example:"AZ"
corridorstring or null^[CR]$

"C" (corridor) to widen the match beyond the source/destination radius circles to include postings reasonably along the route, or "R" (radius) for standard radius-only matching. Automatically overridden to "R" when source and destination are the same city.

Example:"C"
lengthinteger, (int32), [ 1 .. 199 ]required

Equipment length, in feet (1–199). Required.

Example:53
weightinteger, (int32), [ 1 .. 99999 ]required

Equipment weight capacity, in lbs (1–99,999). Required.

Example:45000
ratenumber or null, < 100000

Rate amount. Brokers: total trip cost. Carriers: per-mile rate. Must be less than 100,000.

Example:2.1
currencyinteger or null

Currency code: 0 = USD, 1 = CAD.

Enum:01
Example:0
curl -i -X POST \
  https://azuatgateway.loadlink.ca/freight-matching/v2/postings/equipment \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "dateAvail": "2026-07-20T08:00:00Z",
    "srceCity": "Sarnia",
    "srceSt": "ON",
    "srceRadius": 200,
    "destCity": "Brampton",
    "destSt": "ON",
    "destRadius": 200,
    "vehicleSize": "T",
    "vehicleType": "VR",
    "contactEmail": "dispatch@example.com",
    "contactPhone": null,
    "comment": "Reefer unit available",
    "postingAttrib": "AZ",
    "corridor": "C",
    "length": 53,
    "weight": 45000,
    "rate": 2.1,
    "currency": 0
  }'

Responses

Posting created

Bodyapplication/json
tokeninteger, (int32)

Unique identifier for the newly created posting. Use this same value as the {token} in GET /v2/leads/equipment/{token} to retrieve leads for this posting, and in GET/DELETE /v2/postings/equipment/{token} to look up or remove it.

messagestring

Human-readable confirmation message.

createdAtstring, (date-time)

Date/time the posting was created, in UTC.

Response
{ "token": 654321, "message": "Equipment posting created successfully", "createdAt": "2026-07-15T09:15:00Z" }