Get the list of relationships with carriers

SecurityAuthToken
Request
query Parameters
page
integer

indicates what page of a list of query results you want to view

page-size
integer

indicates the how many items to return per page in a list request

ordering
string

Determines which column to sort by. Prepend with '-' to sort desc.

q
string

search query

id
Array of strings <uuid>

Return objects whose ID is one of those provided

carrier_owner_id
string <uuid>

Return vendor relationships where carrier_owner has this User ID

carrier_owner_email__contains
string

Return vendor relationships where carrier_owner email address contains the value provided

carrier_owner_name__contains
string

Return vendor relationships where carrier_owner name contains the value provided

carrier_status
string

Return vendor relationships where carrier_status equals the value provided

Enum: "ACTIVE" "INACTIVE" "DO_NOT_USE"
billing_address__contains
string

Return objects where the company billing address contains this string

company__contains
string

Return objects where the company name contains this string

mailing_address__contains
string

Return objects where the company mailing address contains this string

primary_email__contains
string

Return objects where the company primary email contains this string

primary_phone_number__contains
string

Return objects where the company primary phone number contains this string

mc_number
string

search by this (exact) mc number

mc_number__contains
string

Return companies where the mc number contains this string

point_of_contacts__contains
string

Return objects where a point of contact contains this string in their name or email

tags
Array of strings

Return objects with these (exact) tags

tags__contains
string

Return objects where one of the tags contains this string

usdot
string

search by this (exact) usdot number

usdot__contains
string

Return companies where the usdot number contains this string

vendor_id
string

Return shipments with this exact value as the vendor Carrier id

load_board_enabled
boolean

Return vendor relationships that have at least one load board enabled point of contact

has_direct_integration
boolean

Return vendor relationships where Shipwell has a direct integration with the vendor

drivers__contains
string

Return objects where a driver contains this string in their full_name or phone_number

Responses
200

Successfully returned a list of carrier relationships

Response Schema: application/json
page_size
integer
Array of objects (SlimCarrierRelationship)
total_count
integer
total_pages
integer
default

Default error response

get/carrier-relationships/
Request samples
Response samples
application/json
{
  • "page_size": 0,
  • "results": [
    ],
  • "total_count": 0,
  • "total_pages": 0
}
Copyright © Shipwell 2025. All right reserved.