---
title: "Search carriers"
method: POST
path: "/carriers/search"
tags: ["Carriers"]
---

# Search carriers

`POST /carriers/search`

Search carriers using OpenSearch-powered full-text and field-specific search.

This endpoint searches both:
- **ONBOARDED carriers**: Carriers with profiles in your organization
- **FMCSA carriers**: Public carrier records from FMCSA database

Features:
- Full-text search across multiple fields
- Field-specific filtering with various operators
- Sorting and pagination
- Saved search preferences

**Note:** Only active (non-deleted) carriers are searchable. Soft-deleted records are automatically excluded from all search results.

**Response Formats:**
- `flat` (default): Returns indexed fields only for faster performance
- `full`: Returns complete carrier objects with all relationships

## Request body

- CarrierSearchRequest — Request body for searching carriers
  - `criteria` CarrierSearchCriteria — Search criteria for filtering carriers. Note: Only active (non-deleted) carriers are searchable. Soft-deleted records are automatically excluded.
    - `id` UUIDSearchCriteria — Search criteria for UUID fields
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any UUID in array - `NOT_ONE_OF`: Does not match any UUID in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of UUIDs for ONE_OF or NOT_ONE_OF operators
    - `carrierProfileId` UUIDSearchCriteria — Search criteria for UUID fields
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any UUID in array - `NOT_ONE_OF`: Does not match any UUID in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of UUIDs for ONE_OF or NOT_ONE_OF operators
    - `goldenCarrierId` UUIDSearchCriteria — Search criteria for UUID fields
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any UUID in array - `NOT_ONE_OF`: Does not match any UUID in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of UUIDs for ONE_OF or NOT_ONE_OF operators
    - `friendlyId` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `name` TextSearchCriteria — Search criteria for text fields (supports wildcards and partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'STARTS_WITH' | 'ENDS_WITH' | 'INCLUDES' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `STARTS_WITH`: Begins with prefix - `ENDS_WITH`: Ends with suffix - `INCLUDES`: Contains substring - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `carrierStatus` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `type` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `city` TextSearchCriteria — Search criteria for text fields (supports wildcards and partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'STARTS_WITH' | 'ENDS_WITH' | 'INCLUDES' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `STARTS_WITH`: Begins with prefix - `ENDS_WITH`: Ends with suffix - `INCLUDES`: Contains substring - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `market` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `zone` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `primaryContactName` TextSearchCriteria — Search criteria for text fields (supports wildcards and partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'STARTS_WITH' | 'ENDS_WITH' | 'INCLUDES' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `STARTS_WITH`: Begins with prefix - `ENDS_WITH`: Ends with suffix - `INCLUDES`: Contains substring - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `primaryContactPhone` TextSearchCriteria — Search criteria for text fields (supports wildcards and partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'STARTS_WITH' | 'ENDS_WITH' | 'INCLUDES' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `STARTS_WITH`: Begins with prefix - `ENDS_WITH`: Ends with suffix - `INCLUDES`: Contains substring - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `primaryContactEmail` TextSearchCriteria — Search criteria for text fields (supports wildcards and partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'STARTS_WITH' | 'ENDS_WITH' | 'INCLUDES' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `STARTS_WITH`: Begins with prefix - `ENDS_WITH`: Ends with suffix - `INCLUDES`: Contains substring - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `fmcsaStatus` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `mcNumber` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `dotNumber` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `einNumber` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `safetyRating` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `equipments` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `powerUnits` IntSearchCriteria — Search criteria for integer fields
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'GREATER_THAN' | 'LESS_THAN' | 'BETWEEN' | 'NOT_BETWEEN' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `GREATER_THAN`: Greater than value - `LESS_THAN`: Less than value - `BETWEEN`: Between min and max (inclusive) - `NOT_BETWEEN`: Not between min and max - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `value` integer — Single value for EQUALS, NOT_EQUALS, GREATER_THAN, LESS_THAN
      - `min` integer — Minimum value for BETWEEN or NOT_BETWEEN
      - `max` integer — Maximum value for BETWEEN or NOT_BETWEEN
    - `trucks` IntSearchCriteria — Search criteria for integer fields
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'GREATER_THAN' | 'LESS_THAN' | 'BETWEEN' | 'NOT_BETWEEN' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `GREATER_THAN`: Greater than value - `LESS_THAN`: Less than value - `BETWEEN`: Between min and max (inclusive) - `NOT_BETWEEN`: Not between min and max - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `value` integer — Single value for EQUALS, NOT_EQUALS, GREATER_THAN, LESS_THAN
      - `min` integer — Minimum value for BETWEEN or NOT_BETWEEN
      - `max` integer — Maximum value for BETWEEN or NOT_BETWEEN
    - `monthsActiveAuthority` IntSearchCriteria — Search criteria for integer fields
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'GREATER_THAN' | 'LESS_THAN' | 'BETWEEN' | 'NOT_BETWEEN' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `GREATER_THAN`: Greater than value - `LESS_THAN`: Less than value - `BETWEEN`: Between min and max (inclusive) - `NOT_BETWEEN`: Not between min and max - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `value` integer — Single value for EQUALS, NOT_EQUALS, GREATER_THAN, LESS_THAN
      - `min` integer — Minimum value for BETWEEN or NOT_BETWEEN
      - `max` integer — Maximum value for BETWEEN or NOT_BETWEEN
    - `highwayId` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `highwayRulesAssessment` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `rmisId` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `rmisOperatingStatus` TextSearchCriteria — Search criteria for text fields (supports wildcards and partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'STARTS_WITH' | 'ENDS_WITH' | 'INCLUDES' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `STARTS_WITH`: Begins with prefix - `ENDS_WITH`: Ends with suffix - `INCLUDES`: Contains substring - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `rmisInvitationStatus` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `mcpStatus` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `mcpReviewStatus` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `quickbooksVendorId` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `factorBankNames` TextSearchCriteria — Search criteria for text fields (supports wildcards and partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'STARTS_WITH' | 'ENDS_WITH' | 'INCLUDES' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `STARTS_WITH`: Begins with prefix - `ENDS_WITH`: Ends with suffix - `INCLUDES`: Contains substring - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `paymentTermName` KeywordSearchCriteria — Search criteria for keyword fields (exact match, no partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `quickPayFee` FloatSearchCriteria — Search criteria for float/decimal fields
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'GREATER_THAN' | 'LESS_THAN' | 'BETWEEN' | 'NOT_BETWEEN' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `GREATER_THAN`: Greater than value - `LESS_THAN`: Less than value - `BETWEEN`: Between min and max (inclusive) - `NOT_BETWEEN`: Not between min and max - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `value` number, float — Single value for EQUALS, NOT_EQUALS, GREATER_THAN, LESS_THAN
      - `min` number, float — Minimum value for BETWEEN or NOT_BETWEEN
      - `max` number, float — Maximum value for BETWEEN or NOT_BETWEEN
    - `accountOwnerId` UUIDSearchCriteria — Search criteria for UUID fields
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `ONE_OF`: Matches any UUID in array - `NOT_ONE_OF`: Does not match any UUID in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of UUIDs for ONE_OF or NOT_ONE_OF operators
    - `accountOwnerName` TextSearchCriteria — Search criteria for text fields (supports wildcards and partial matching)
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'STARTS_WITH' | 'ENDS_WITH' | 'INCLUDES' | 'ONE_OF' | 'NOT_ONE_OF' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `STARTS_WITH`: Begins with prefix - `ENDS_WITH`: Ends with suffix - `INCLUDES`: Contains substring - `ONE_OF`: Matches any value in array - `NOT_ONE_OF`: Does not match any value in array - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `values` string[] — Array of values for ONE_OF or NOT_ONE_OF operators
    - `loadsCount` IntSearchCriteria — Search criteria for integer fields
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'GREATER_THAN' | 'LESS_THAN' | 'BETWEEN' | 'NOT_BETWEEN' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `GREATER_THAN`: Greater than value - `LESS_THAN`: Less than value - `BETWEEN`: Between min and max (inclusive) - `NOT_BETWEEN`: Not between min and max - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `value` integer — Single value for EQUALS, NOT_EQUALS, GREATER_THAN, LESS_THAN
      - `min` integer — Minimum value for BETWEEN or NOT_BETWEEN
      - `max` integer — Maximum value for BETWEEN or NOT_BETWEEN
    - `totalMiles` FloatSearchCriteria — Search criteria for float/decimal fields
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'GREATER_THAN' | 'LESS_THAN' | 'BETWEEN' | 'NOT_BETWEEN' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `GREATER_THAN`: Greater than value - `LESS_THAN`: Less than value - `BETWEEN`: Between min and max (inclusive) - `NOT_BETWEEN`: Not between min and max - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `value` number, float — Single value for EQUALS, NOT_EQUALS, GREATER_THAN, LESS_THAN
      - `min` number, float — Minimum value for BETWEEN or NOT_BETWEEN
      - `max` number, float — Maximum value for BETWEEN or NOT_BETWEEN
    - `totalRevenue` FloatSearchCriteria — Search criteria for float/decimal fields
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'GREATER_THAN' | 'LESS_THAN' | 'BETWEEN' | 'NOT_BETWEEN' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `GREATER_THAN`: Greater than value - `LESS_THAN`: Less than value - `BETWEEN`: Between min and max (inclusive) - `NOT_BETWEEN`: Not between min and max - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `value` number, float — Single value for EQUALS, NOT_EQUALS, GREATER_THAN, LESS_THAN
      - `min` number, float — Minimum value for BETWEEN or NOT_BETWEEN
      - `max` number, float — Maximum value for BETWEEN or NOT_BETWEEN
    - `totalCostOfGoodsSold` FloatSearchCriteria — Search criteria for float/decimal fields
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'GREATER_THAN' | 'LESS_THAN' | 'BETWEEN' | 'NOT_BETWEEN' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `GREATER_THAN`: Greater than value - `LESS_THAN`: Less than value - `BETWEEN`: Between min and max (inclusive) - `NOT_BETWEEN`: Not between min and max - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `value` number, float — Single value for EQUALS, NOT_EQUALS, GREATER_THAN, LESS_THAN
      - `min` number, float — Minimum value for BETWEEN or NOT_BETWEEN
      - `max` number, float — Maximum value for BETWEEN or NOT_BETWEEN
    - `ratePerMile` FloatSearchCriteria — Search criteria for float/decimal fields
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'GREATER_THAN' | 'LESS_THAN' | 'BETWEEN' | 'NOT_BETWEEN' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `GREATER_THAN`: Greater than value - `LESS_THAN`: Less than value - `BETWEEN`: Between min and max (inclusive) - `NOT_BETWEEN`: Not between min and max - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `value` number, float — Single value for EQUALS, NOT_EQUALS, GREATER_THAN, LESS_THAN
      - `min` number, float — Minimum value for BETWEEN or NOT_BETWEEN
      - `max` number, float — Maximum value for BETWEEN or NOT_BETWEEN
    - `quotesCount` IntSearchCriteria — Search criteria for integer fields
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'GREATER_THAN' | 'LESS_THAN' | 'BETWEEN' | 'NOT_BETWEEN' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `GREATER_THAN`: Greater than value - `LESS_THAN`: Less than value - `BETWEEN`: Between min and max (inclusive) - `NOT_BETWEEN`: Not between min and max - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `value` integer — Single value for EQUALS, NOT_EQUALS, GREATER_THAN, LESS_THAN
      - `min` integer — Minimum value for BETWEEN or NOT_BETWEEN
      - `max` integer — Maximum value for BETWEEN or NOT_BETWEEN
    - `createdAt` DatetimeSearchCriteria — Search criteria for datetime fields. Supports both absolute datetime values and relative time expressions.
      - `operator` 'EQUALS' | 'NOT_EQUALS' | 'BEFORE' | 'AFTER' | 'BETWEEN' | 'NOT_BETWEEN' | 'EXISTS' | 'DOES_NOT_EXIST', required — Search operator: - `EQUALS`: Exact match - `NOT_EQUALS`: Not equal to - `BEFORE`: Before datetime - `AFTER`: After datetime - `BETWEEN`: Between min and max (inclusive) - `NOT_BETWEEN`: Not between min and max - `EXISTS`: Field has a value (not null) - `DOES_NOT_EXIST`: Field is null
      - `value` string, date-time — Absolute datetime for EQUALS, NOT_EQUALS
      - `min` string, date-time — Minimum datetime for BETWEEN or NOT_BETWEEN
      - `max` string, date-time — Maximum datetime for BETWEEN or NOT_BETWEEN
      - `valueRelative` integer — Relative time from now (negative for past, positive for future). Example: -7 with WEEK unit means 7 weeks ago.
      - `valueRelativeUnit` 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND' — Time unit for relative time calculations: - `YEAR`: Years - `MONTH`: Months - `WEEK`: Weeks - `DAY`: Days - `HOUR`: Hours - `MINUTE`: Minutes - `SECOND`: Seconds
      - `minRelative` integer — Relative time for min boundary
      - `minRelativeUnit` 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND' — Time unit for relative time calculations: - `YEAR`: Years - `MONTH`: Months - `WEEK`: Weeks - `DAY`: Days - `HOUR`: Hours - `MINUTE`: Minutes - `SECOND`: Seconds
      - `maxRelative` integer — Relative time for max boundary
      - `maxRelativeUnit` 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND' — Time unit for relative time calculations: - `YEAR`: Years - `MONTH`: Months - `WEEK`: Weeks - `DAY`: Days - `HOUR`: Hours - `MINUTE`: Minutes - `SECOND`: Seconds
  - `pagination` SearchPaginationInput — Pagination options for search requests
    - `pageNumber` integer — Page number (1-based)
    - `pageSize` integer — Number of results per page (max 250)
  - `sort` SearchSortOption[] — Sort options for the search results
    - `field` string, required — Field name to sort by (must be an indexed field)
    - `order` 'asc' | 'desc', required — Sort direction (ascending or descending)
  - `savedSearch` SavedSearchLookup — Reference to a saved search by ID or client key. Provide either id or key (not both).
    - `id` string, uuid — Saved search UUID
    - `key` string — Client-defined key for the saved search
  - `format` 'flat' | 'full' — Response format: - flat: Returns only indexed fields (default, faster) - full: Returns complete carrier objects

## Response `200`

Successful search results

- CarrierSearchResponse — Response for carrier search requests. Note: Only active (non-deleted) carriers are included in results.
  - `data` union[], required — Search results - either flat rows or full carrier objects based on format parameter
    - union
      - CarrierSearchRow — Flattened carrier data from search index. Includes both ONBOARDED carriers and FMCSA records.
        - `object` 'CARRIER_SEARCH_ROW', required — Object type identifier for discriminating between flat and full response formats
        - `id` string, uuid, required — Carrier ID (carrierProfileId if onboarded, goldenCarrierId otherwise)
        - `carrierProfileId` string, uuid, nullable — Profile ID (only for onboarded carriers)
        - `goldenCarrierId` string, uuid, required — Golden carrier ID from FMCSA
        - `friendlyId` string, nullable — Account ID (only for onboarded carriers)
        - `name` string, required — Carrier company name
        - `carrierStatus` 'pending' | 'active' | 'inactive' | 'doNotUse', nullable — Status (only for onboarded carriers)
        - `type` 'TL' | 'LTL' | 'LINEHAUL' | 'CARTAGE' | 'AIR' | 'OCEAN' | 'RAIL', nullable
        - `city` string, nullable
        - `market` string, nullable — DAT market
        - `zone` string, nullable — DAT zone
        - `primaryContactName` string, nullable
        - `primaryContactPhone` string, nullable
        - `primaryContactEmail` string, email, nullable
        - `fmcsaStatus` 'active' | 'inactive', nullable
        - `mcNumber` string, nullable
        - `dotNumber` string, nullable
        - `einNumber` string, nullable
        - `safetyRating` string, nullable
        - `equipments` string[] — Equipment types available
        - `powerUnits` integer, nullable
        - `trucks` integer, nullable
        - `monthsActiveAuthority` integer, nullable — Months of active authority
        - `highwayId` string, nullable
        - `highwayRulesAssessment` string, nullable
        - `rmisId` string, nullable
        - `rmisOperatingStatus` string, nullable
        - `rmisInvitationStatus` 'ERROR' | 'INVITED' | 'SUCCESS', nullable
        - `mcpStatus` 'complete' | 'invited' | 'notInvited' | 'inProcess' | 'incomplete', nullable — MyCarrierPortal invite status
        - `mcpReviewStatus` 'acceptable' | 'moderate' | 'unacceptable', nullable — MyCarrierPortal review status
        - `quickbooksVendorId` string, nullable — QuickBooks Online vendor ID
        - `factorBankNames` string[] — Factoring companies
        - `paymentTermName` string, nullable
        - `quickPayFee` number, float, nullable — Quick pay discount rate
        - `accountOwnerId` string, uuid, nullable
        - `accountOwnerName` string, nullable
        - `loadsCount` integer, nullable — Number of loads delivered
        - `totalMiles` number, float, nullable
        - `totalRevenue` number, float, nullable
        - `totalCostOfGoodsSold` number, float, nullable
        - `ratePerMile` number, float, nullable — Average rate per mile
        - `quotesCount` integer, nullable
        - `createdAt` string, date-time, nullable — Onboarding date
      - union
        - TruckloadCarrier — Truckload carrier with insurance, safety rating, and FMCSA data
          - `object` 'CARRIER' — Object type identifier
          - `id` string, uuid, required — Unique carrier identifier
          - `friendlyId` string, required — Human-readable carrier identifier
          - `type` 'TRUCKLOAD', required — Carrier type discriminator
          - `name` string, required — Carrier legal name
          - `dbaName` string, nullable — Doing Business As name
          - `key` string, nullable — Client-defined reference identifier
          - `email` string, email, nullable — Primary email address
          - `phone` string, nullable — Primary phone number
          - `website` string, nullable — Company website URL
          - `status` string, required — Carrier status
          - `statusReason` string, nullable — Reason for current status
          - `notes` string, nullable — Internal notes about the carrier
          - `corporateAddress` Address — Physical address/location details (nested, without id). This is an embedded object representing a Location record. The id is managed internally and not exposed in the API.
            - `line1` string, required — Primary street address line
            - `line2` string, nullable — Secondary address line (suite, floor, etc.)
            - `city` string, required — City name
            - `country` string, required — Country name or code
            - `market` string, required — Market or region identifier
            - `latitude` string, nullable — Latitude coordinate
            - `longitude` string, nullable — Longitude coordinate
            - `isAirportOrAirbase` boolean, required — Whether this location is an airport or airbase
            - `isConstructionOrUtilitySite` boolean, required — Whether this location is a construction or utility site
            - `isSmartyValidated` boolean, required — Whether address has been validated by SmartyStreets
            - `obeysDst` boolean, required — Whether this location observes daylight saving time
            - `cityId` string, uuid, nullable — Reference to standardized city record (internal use)
          - `billingAddress` Address — Physical address/location details (nested, without id). This is an embedded object representing a Location record. The id is managed internally and not exposed in the API.
            - `line1` string, required — Primary street address line
            - `line2` string, nullable — Secondary address line (suite, floor, etc.)
            - `city` string, required — City name
            - `country` string, required — Country name or code
            - `market` string, required — Market or region identifier
            - `latitude` string, nullable — Latitude coordinate
            - `longitude` string, nullable — Longitude coordinate
            - `isAirportOrAirbase` boolean, required — Whether this location is an airport or airbase
            - `isConstructionOrUtilitySite` boolean, required — Whether this location is a construction or utility site
            - `isSmartyValidated` boolean, required — Whether address has been validated by SmartyStreets
            - `obeysDst` boolean, required — Whether this location observes daylight saving time
            - `cityId` string, uuid, nullable — Reference to standardized city record (internal use)
          - `mcNumber` string, nullable — Motor Carrier (MC) number
          - `dotNumber` string, nullable — Department of Transportation (DOT) number
          - `scac` string, nullable — Standard Carrier Alpha Code
          - `einNumber` string, nullable — Employer Identification Number
          - `ffNumber` string, nullable — Freight Forwarder (FF) number
          - `mxNumber` string, nullable — Mexico carrier registration number
          - `rfcNumber` string, nullable — RFC (Mexico tax ID) number
          - `iataCode` string, nullable — International Air Transport Association code
          - `equipments` CarrierEquipment[] — Equipment types this carrier operates
          - `isHazmat` boolean, nullable — Whether carrier is certified to transport hazardous materials
          - `tsaApproved` boolean, nullable — Whether carrier is TSA approved
          - `trucks` integer, nullable — Number of trucks in fleet
          - `trailers` integer, nullable — Number of trailers in fleet
          - `drivers` integer, nullable — Number of drivers employed
          - `powerUnits` integer, nullable — Number of power units
          - `currency` 'ARS' | 'AUD' | 'BRL' | 'CAD' | 'CNY' | 'EUR' | 'GBP' | 'IDR' | 'INR' | 'JPY' | 'KRW' | 'MXN' | 'RUB' | 'SAR' | 'TRY' | 'USD' | 'ZAR' — Currency code (ISO 4217)
          - `paymentTerm` PaymentTermReference — Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.
            - `id` string, uuid, required — Payment term UUID
            - `key` string, nullable — Client-defined reference ID if set
            - `name` string, required — Payment term name
            - `description` string, nullable — Payment term description or notes
            - `days` integer, nullable — Number of days until payment is due
            - `quickPayFee` number, float, nullable — Quick pay fee percentage (e.g., 0.05 for 5%)
            - `apOnly` boolean, nullable — Whether this payment term is for accounts payable only
            - `doNotUse` boolean, nullable — Flag to prevent using this payment term for new transactions
            - `createdAt` string, date-time, required — When the payment term was created
            - `updatedAt` string, date-time, required — When the payment term was last updated
            - `deletedAt` string, date-time, nullable — When the payment term was soft deleted (null if active)
          - `isFactoringPreferred` boolean, nullable — Whether carrier prefers factoring for payment
          - `goldenCarrierId` string, uuid, nullable — Reference to golden carrier record (for deduplication)
          - `paymentMethods` CarrierPaymentMethodReference[] — Payment methods configured for this carrier
            - `id` string, uuid, required — Unique carrier payment method identifier
            - `key` string, nullable — Client-defined reference identifier
            - `paymentRecipientType` 'DIRECT' | 'FACTOR', required — Who receives the payment. - `DIRECT`: Payment goes directly to the carrier - `FACTOR`: Payment goes to a factoring company (requires carrierFactorId)
            - `paymentMethodType` 'ACH_WIRE' | 'ZELLE' | 'VENMO' | 'ACH' | 'CHECK' | 'WIRE' | 'CAD_EFT' | 'TRIUMPH_PAY' | 'COMCHECK' | 'EFS' | 'ECHECK', required — Payment method type
            - `status` string, nullable — Payment method status
            - `isPreferred` boolean, nullable — Whether this is the preferred payment method
            - `email` string, email, nullable — Email address for payment notifications
            - `phone` string, nullable — Phone number for payment contact
            - `companyName` string, nullable — Company name for this payment method
            - `username` string, nullable — Username for payment platforms
            - `bankName` string, nullable — Bank name
            - `bankAddress` string, nullable — Bank address
            - `accountName` string, nullable — Bank account holder name
            - `accountNumber` string, nullable — Bank account number (masked in responses)
            - `abaAch` string, nullable — ABA/ACH routing number
            - `wire` string, nullable — Wire transfer routing number
            - `swiftCode` string, nullable — SWIFT/BIC code
            - `eftInstitution` string, nullable — EFT institution number (Canadian banking)
            - `eftTransit` string, nullable — EFT transit number (Canadian banking)
            - `clabe` string, nullable — CLABE number (Mexican banking)
            - `currency` string, nullable — Preferred currency code
            - `carrierFactor` CarrierFactorReference — Enhanced reference to a carrier factor (factoring company). Includes full carrier factor details in addition to id/key.
              - …
            - `paymentTerm` PaymentTermReference — Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.
              - …
            - `createdAt` string, date-time, required — When the payment method was created
            - `updatedAt` string, date-time, required — When the payment method was last updated
            - `deletedAt` string, date-time, nullable — When the payment method was soft deleted
            - `deletedBy` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
          - `contacts` CarrierContactReference[] — Contacts for this carrier
            - `object` 'CARRIER_CONTACT' — Object type identifier
            - `id` string, uuid, required — Unique contact identifier
            - `key` string, nullable — Client-defined reference identifier
            - `name` string, required — Contact person's name
            - `contactInfo` ContactInfo, required — Contact information details (nested, without id). This is an embedded object representing a Contact record. The id is managed internally and not exposed in the API.
              - …
            - `contactTypes` CarrierContactType[], nullable — Types/roles this contact serves
            - `invitedUser` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
            - `deletedBy` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
            - `createdAt` string, date-time, required — When the contact was created
            - `deletedAt` string, date-time, nullable — When the contact was soft deleted
          - `createdAt` string, date-time, required — When the carrier was created
          - `updatedAt` string, date-time, required — When the carrier was last updated
          - `deletedAt` string, date-time, nullable — When the carrier was soft deleted (null if active)
          - `insuranceCompany` string, nullable — Insurance company name
          - `insuranceAgent` string, nullable — Insurance agent name
          - `insuranceAgentPhone` string, nullable — Insurance agent phone number
          - `insuranceAuthorityDate` string, date-time, nullable — Date insurance authority was granted
          - `insuranceExpirationDate` string, date-time, nullable — Insurance policy expiration date
          - `insuranceAutoLiabilityLimit` number, float, nullable — Auto liability insurance limit (in dollars)
          - `insuranceCargoLiabilityLimit` number, float, nullable — Cargo liability insurance limit (in dollars)
          - `insuranceGeneralLiabilityLimit` number, float, nullable — General liability insurance limit (in dollars)
          - `rating` string, nullable — Carrier safety rating
          - `ratingDate` string, date, nullable — Date of last safety rating
          - `reviewType` string, nullable — Type of safety review conducted
          - `reviewDate` string, date, nullable — Date of last safety review
          - `operatingAbility` string, nullable — FMCSA operating authority status
          - `inFmcsa` boolean, nullable — Whether carrier is registered in FMCSA database
          - `usDriverInspections` integer, nullable — Total number of US driver inspections
          - `usDriverInspectionsOos` integer, nullable — Number of US driver inspections resulting in out-of-service
          - `usDriverInspectionsOosPct` number, float, nullable — Percentage of US driver inspections resulting in out-of-service
          - `usVehicleInspections` integer, nullable — Total number of US vehicle inspections
          - `usVehicleInspectionsOos` integer, nullable — Number of US vehicle inspections resulting in out-of-service
          - `usVehicleInspectionsOosPct` number, float, nullable — Percentage of US vehicle inspections resulting in out-of-service
        - AirCarrier — Air cargo carrier
          - `object` 'CARRIER' — Object type identifier
          - `id` string, uuid, required — Unique carrier identifier
          - `friendlyId` string, required — Human-readable carrier identifier
          - `type` 'AIR', required — Carrier type discriminator
          - `name` string, required — Carrier legal name
          - `dbaName` string, nullable — Doing Business As name
          - `key` string, nullable — Client-defined reference identifier
          - `email` string, email, nullable — Primary email address
          - `phone` string, nullable — Primary phone number
          - `website` string, nullable — Company website URL
          - `status` string, required — Carrier status
          - `statusReason` string, nullable — Reason for current status
          - `notes` string, nullable — Internal notes about the carrier
          - `corporateAddress` Address — Physical address/location details (nested, without id). This is an embedded object representing a Location record. The id is managed internally and not exposed in the API.
            - `line1` string, required — Primary street address line
            - `line2` string, nullable — Secondary address line (suite, floor, etc.)
            - `city` string, required — City name
            - `country` string, required — Country name or code
            - `market` string, required — Market or region identifier
            - `latitude` string, nullable — Latitude coordinate
            - `longitude` string, nullable — Longitude coordinate
            - `isAirportOrAirbase` boolean, required — Whether this location is an airport or airbase
            - `isConstructionOrUtilitySite` boolean, required — Whether this location is a construction or utility site
            - `isSmartyValidated` boolean, required — Whether address has been validated by SmartyStreets
            - `obeysDst` boolean, required — Whether this location observes daylight saving time
            - `cityId` string, uuid, nullable — Reference to standardized city record (internal use)
          - `billingAddress` Address — Physical address/location details (nested, without id). This is an embedded object representing a Location record. The id is managed internally and not exposed in the API.
            - `line1` string, required — Primary street address line
            - `line2` string, nullable — Secondary address line (suite, floor, etc.)
            - `city` string, required — City name
            - `country` string, required — Country name or code
            - `market` string, required — Market or region identifier
            - `latitude` string, nullable — Latitude coordinate
            - `longitude` string, nullable — Longitude coordinate
            - `isAirportOrAirbase` boolean, required — Whether this location is an airport or airbase
            - `isConstructionOrUtilitySite` boolean, required — Whether this location is a construction or utility site
            - `isSmartyValidated` boolean, required — Whether address has been validated by SmartyStreets
            - `obeysDst` boolean, required — Whether this location observes daylight saving time
            - `cityId` string, uuid, nullable — Reference to standardized city record (internal use)
          - `mcNumber` string, nullable — Motor Carrier (MC) number
          - `dotNumber` string, nullable — Department of Transportation (DOT) number
          - `scac` string, nullable — Standard Carrier Alpha Code
          - `einNumber` string, nullable — Employer Identification Number
          - `ffNumber` string, nullable — Freight Forwarder (FF) number
          - `mxNumber` string, nullable — Mexico carrier registration number
          - `rfcNumber` string, nullable — RFC (Mexico tax ID) number
          - `iataCode` string, nullable — International Air Transport Association code
          - `equipments` CarrierEquipment[] — Equipment types this carrier operates
          - `isHazmat` boolean, nullable — Whether carrier is certified to transport hazardous materials
          - `tsaApproved` boolean, nullable — Whether carrier is TSA approved
          - `trucks` integer, nullable — Number of trucks in fleet
          - `trailers` integer, nullable — Number of trailers in fleet
          - `drivers` integer, nullable — Number of drivers employed
          - `powerUnits` integer, nullable — Number of power units
          - `currency` 'ARS' | 'AUD' | 'BRL' | 'CAD' | 'CNY' | 'EUR' | 'GBP' | 'IDR' | 'INR' | 'JPY' | 'KRW' | 'MXN' | 'RUB' | 'SAR' | 'TRY' | 'USD' | 'ZAR' — Currency code (ISO 4217)
          - `paymentTerm` PaymentTermReference — Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.
            - `id` string, uuid, required — Payment term UUID
            - `key` string, nullable — Client-defined reference ID if set
            - `name` string, required — Payment term name
            - `description` string, nullable — Payment term description or notes
            - `days` integer, nullable — Number of days until payment is due
            - `quickPayFee` number, float, nullable — Quick pay fee percentage (e.g., 0.05 for 5%)
            - `apOnly` boolean, nullable — Whether this payment term is for accounts payable only
            - `doNotUse` boolean, nullable — Flag to prevent using this payment term for new transactions
            - `createdAt` string, date-time, required — When the payment term was created
            - `updatedAt` string, date-time, required — When the payment term was last updated
            - `deletedAt` string, date-time, nullable — When the payment term was soft deleted (null if active)
          - `isFactoringPreferred` boolean, nullable — Whether carrier prefers factoring for payment
          - `goldenCarrierId` string, uuid, nullable — Reference to golden carrier record (for deduplication)
          - `paymentMethods` CarrierPaymentMethodReference[] — Payment methods configured for this carrier
            - `id` string, uuid, required — Unique carrier payment method identifier
            - `key` string, nullable — Client-defined reference identifier
            - `paymentRecipientType` 'DIRECT' | 'FACTOR', required — Who receives the payment. - `DIRECT`: Payment goes directly to the carrier - `FACTOR`: Payment goes to a factoring company (requires carrierFactorId)
            - `paymentMethodType` 'ACH_WIRE' | 'ZELLE' | 'VENMO' | 'ACH' | 'CHECK' | 'WIRE' | 'CAD_EFT' | 'TRIUMPH_PAY' | 'COMCHECK' | 'EFS' | 'ECHECK', required — Payment method type
            - `status` string, nullable — Payment method status
            - `isPreferred` boolean, nullable — Whether this is the preferred payment method
            - `email` string, email, nullable — Email address for payment notifications
            - `phone` string, nullable — Phone number for payment contact
            - `companyName` string, nullable — Company name for this payment method
            - `username` string, nullable — Username for payment platforms
            - `bankName` string, nullable — Bank name
            - `bankAddress` string, nullable — Bank address
            - `accountName` string, nullable — Bank account holder name
            - `accountNumber` string, nullable — Bank account number (masked in responses)
            - `abaAch` string, nullable — ABA/ACH routing number
            - `wire` string, nullable — Wire transfer routing number
            - `swiftCode` string, nullable — SWIFT/BIC code
            - `eftInstitution` string, nullable — EFT institution number (Canadian banking)
            - `eftTransit` string, nullable — EFT transit number (Canadian banking)
            - `clabe` string, nullable — CLABE number (Mexican banking)
            - `currency` string, nullable — Preferred currency code
            - `carrierFactor` CarrierFactorReference — Enhanced reference to a carrier factor (factoring company). Includes full carrier factor details in addition to id/key.
              - …
            - `paymentTerm` PaymentTermReference — Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.
              - …
            - `createdAt` string, date-time, required — When the payment method was created
            - `updatedAt` string, date-time, required — When the payment method was last updated
            - `deletedAt` string, date-time, nullable — When the payment method was soft deleted
            - `deletedBy` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
          - `contacts` CarrierContactReference[] — Contacts for this carrier
            - `object` 'CARRIER_CONTACT' — Object type identifier
            - `id` string, uuid, required — Unique contact identifier
            - `key` string, nullable — Client-defined reference identifier
            - `name` string, required — Contact person's name
            - `contactInfo` ContactInfo, required — Contact information details (nested, without id). This is an embedded object representing a Contact record. The id is managed internally and not exposed in the API.
              - …
            - `contactTypes` CarrierContactType[], nullable — Types/roles this contact serves
            - `invitedUser` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
            - `deletedBy` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
            - `createdAt` string, date-time, required — When the contact was created
            - `deletedAt` string, date-time, nullable — When the contact was soft deleted
          - `createdAt` string, date-time, required — When the carrier was created
          - `updatedAt` string, date-time, required — When the carrier was last updated
          - `deletedAt` string, date-time, nullable — When the carrier was soft deleted (null if active)
        - CartageCarrier — Cartage (local pickup/delivery) carrier
          - `object` 'CARRIER' — Object type identifier
          - `id` string, uuid, required — Unique carrier identifier
          - `friendlyId` string, required — Human-readable carrier identifier
          - `type` 'CARTAGE', required — Carrier type discriminator
          - `name` string, required — Carrier legal name
          - `dbaName` string, nullable — Doing Business As name
          - `key` string, nullable — Client-defined reference identifier
          - `email` string, email, nullable — Primary email address
          - `phone` string, nullable — Primary phone number
          - `website` string, nullable — Company website URL
          - `status` string, required — Carrier status
          - `statusReason` string, nullable — Reason for current status
          - `notes` string, nullable — Internal notes about the carrier
          - `corporateAddress` Address — Physical address/location details (nested, without id). This is an embedded object representing a Location record. The id is managed internally and not exposed in the API.
            - `line1` string, required — Primary street address line
            - `line2` string, nullable — Secondary address line (suite, floor, etc.)
            - `city` string, required — City name
            - `country` string, required — Country name or code
            - `market` string, required — Market or region identifier
            - `latitude` string, nullable — Latitude coordinate
            - `longitude` string, nullable — Longitude coordinate
            - `isAirportOrAirbase` boolean, required — Whether this location is an airport or airbase
            - `isConstructionOrUtilitySite` boolean, required — Whether this location is a construction or utility site
            - `isSmartyValidated` boolean, required — Whether address has been validated by SmartyStreets
            - `obeysDst` boolean, required — Whether this location observes daylight saving time
            - `cityId` string, uuid, nullable — Reference to standardized city record (internal use)
          - `billingAddress` Address — Physical address/location details (nested, without id). This is an embedded object representing a Location record. The id is managed internally and not exposed in the API.
            - `line1` string, required — Primary street address line
            - `line2` string, nullable — Secondary address line (suite, floor, etc.)
            - `city` string, required — City name
            - `country` string, required — Country name or code
            - `market` string, required — Market or region identifier
            - `latitude` string, nullable — Latitude coordinate
            - `longitude` string, nullable — Longitude coordinate
            - `isAirportOrAirbase` boolean, required — Whether this location is an airport or airbase
            - `isConstructionOrUtilitySite` boolean, required — Whether this location is a construction or utility site
            - `isSmartyValidated` boolean, required — Whether address has been validated by SmartyStreets
            - `obeysDst` boolean, required — Whether this location observes daylight saving time
            - `cityId` string, uuid, nullable — Reference to standardized city record (internal use)
          - `mcNumber` string, nullable — Motor Carrier (MC) number
          - `dotNumber` string, nullable — Department of Transportation (DOT) number
          - `scac` string, nullable — Standard Carrier Alpha Code
          - `einNumber` string, nullable — Employer Identification Number
          - `ffNumber` string, nullable — Freight Forwarder (FF) number
          - `mxNumber` string, nullable — Mexico carrier registration number
          - `rfcNumber` string, nullable — RFC (Mexico tax ID) number
          - `iataCode` string, nullable — International Air Transport Association code
          - `equipments` CarrierEquipment[] — Equipment types this carrier operates
          - `isHazmat` boolean, nullable — Whether carrier is certified to transport hazardous materials
          - `tsaApproved` boolean, nullable — Whether carrier is TSA approved
          - `trucks` integer, nullable — Number of trucks in fleet
          - `trailers` integer, nullable — Number of trailers in fleet
          - `drivers` integer, nullable — Number of drivers employed
          - `powerUnits` integer, nullable — Number of power units
          - `currency` 'ARS' | 'AUD' | 'BRL' | 'CAD' | 'CNY' | 'EUR' | 'GBP' | 'IDR' | 'INR' | 'JPY' | 'KRW' | 'MXN' | 'RUB' | 'SAR' | 'TRY' | 'USD' | 'ZAR' — Currency code (ISO 4217)
          - `paymentTerm` PaymentTermReference — Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.
            - `id` string, uuid, required — Payment term UUID
            - `key` string, nullable — Client-defined reference ID if set
            - `name` string, required — Payment term name
            - `description` string, nullable — Payment term description or notes
            - `days` integer, nullable — Number of days until payment is due
            - `quickPayFee` number, float, nullable — Quick pay fee percentage (e.g., 0.05 for 5%)
            - `apOnly` boolean, nullable — Whether this payment term is for accounts payable only
            - `doNotUse` boolean, nullable — Flag to prevent using this payment term for new transactions
            - `createdAt` string, date-time, required — When the payment term was created
            - `updatedAt` string, date-time, required — When the payment term was last updated
            - `deletedAt` string, date-time, nullable — When the payment term was soft deleted (null if active)
          - `isFactoringPreferred` boolean, nullable — Whether carrier prefers factoring for payment
          - `goldenCarrierId` string, uuid, nullable — Reference to golden carrier record (for deduplication)
          - `paymentMethods` CarrierPaymentMethodReference[] — Payment methods configured for this carrier
            - `id` string, uuid, required — Unique carrier payment method identifier
            - `key` string, nullable — Client-defined reference identifier
            - `paymentRecipientType` 'DIRECT' | 'FACTOR', required — Who receives the payment. - `DIRECT`: Payment goes directly to the carrier - `FACTOR`: Payment goes to a factoring company (requires carrierFactorId)
            - `paymentMethodType` 'ACH_WIRE' | 'ZELLE' | 'VENMO' | 'ACH' | 'CHECK' | 'WIRE' | 'CAD_EFT' | 'TRIUMPH_PAY' | 'COMCHECK' | 'EFS' | 'ECHECK', required — Payment method type
            - `status` string, nullable — Payment method status
            - `isPreferred` boolean, nullable — Whether this is the preferred payment method
            - `email` string, email, nullable — Email address for payment notifications
            - `phone` string, nullable — Phone number for payment contact
            - `companyName` string, nullable — Company name for this payment method
            - `username` string, nullable — Username for payment platforms
            - `bankName` string, nullable — Bank name
            - `bankAddress` string, nullable — Bank address
            - `accountName` string, nullable — Bank account holder name
            - `accountNumber` string, nullable — Bank account number (masked in responses)
            - `abaAch` string, nullable — ABA/ACH routing number
            - `wire` string, nullable — Wire transfer routing number
            - `swiftCode` string, nullable — SWIFT/BIC code
            - `eftInstitution` string, nullable — EFT institution number (Canadian banking)
            - `eftTransit` string, nullable — EFT transit number (Canadian banking)
            - `clabe` string, nullable — CLABE number (Mexican banking)
            - `currency` string, nullable — Preferred currency code
            - `carrierFactor` CarrierFactorReference — Enhanced reference to a carrier factor (factoring company). Includes full carrier factor details in addition to id/key.
              - …
            - `paymentTerm` PaymentTermReference — Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.
              - …
            - `createdAt` string, date-time, required — When the payment method was created
            - `updatedAt` string, date-time, required — When the payment method was last updated
            - `deletedAt` string, date-time, nullable — When the payment method was soft deleted
            - `deletedBy` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
          - `contacts` CarrierContactReference[] — Contacts for this carrier
            - `object` 'CARRIER_CONTACT' — Object type identifier
            - `id` string, uuid, required — Unique contact identifier
            - `key` string, nullable — Client-defined reference identifier
            - `name` string, required — Contact person's name
            - `contactInfo` ContactInfo, required — Contact information details (nested, without id). This is an embedded object representing a Contact record. The id is managed internally and not exposed in the API.
              - …
            - `contactTypes` CarrierContactType[], nullable — Types/roles this contact serves
            - `invitedUser` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
            - `deletedBy` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
            - `createdAt` string, date-time, required — When the contact was created
            - `deletedAt` string, date-time, nullable — When the contact was soft deleted
          - `createdAt` string, date-time, required — When the carrier was created
          - `updatedAt` string, date-time, required — When the carrier was last updated
          - `deletedAt` string, date-time, nullable — When the carrier was soft deleted (null if active)
        - LinehaulCarrier — Linehaul (long-distance) carrier
          - `object` 'CARRIER' — Object type identifier
          - `id` string, uuid, required — Unique carrier identifier
          - `friendlyId` string, required — Human-readable carrier identifier
          - `type` 'LINEHAUL', required — Carrier type discriminator
          - `name` string, required — Carrier legal name
          - `dbaName` string, nullable — Doing Business As name
          - `key` string, nullable — Client-defined reference identifier
          - `email` string, email, nullable — Primary email address
          - `phone` string, nullable — Primary phone number
          - `website` string, nullable — Company website URL
          - `status` string, required — Carrier status
          - `statusReason` string, nullable — Reason for current status
          - `notes` string, nullable — Internal notes about the carrier
          - `corporateAddress` Address — Physical address/location details (nested, without id). This is an embedded object representing a Location record. The id is managed internally and not exposed in the API.
            - `line1` string, required — Primary street address line
            - `line2` string, nullable — Secondary address line (suite, floor, etc.)
            - `city` string, required — City name
            - `country` string, required — Country name or code
            - `market` string, required — Market or region identifier
            - `latitude` string, nullable — Latitude coordinate
            - `longitude` string, nullable — Longitude coordinate
            - `isAirportOrAirbase` boolean, required — Whether this location is an airport or airbase
            - `isConstructionOrUtilitySite` boolean, required — Whether this location is a construction or utility site
            - `isSmartyValidated` boolean, required — Whether address has been validated by SmartyStreets
            - `obeysDst` boolean, required — Whether this location observes daylight saving time
            - `cityId` string, uuid, nullable — Reference to standardized city record (internal use)
          - `billingAddress` Address — Physical address/location details (nested, without id). This is an embedded object representing a Location record. The id is managed internally and not exposed in the API.
            - `line1` string, required — Primary street address line
            - `line2` string, nullable — Secondary address line (suite, floor, etc.)
            - `city` string, required — City name
            - `country` string, required — Country name or code
            - `market` string, required — Market or region identifier
            - `latitude` string, nullable — Latitude coordinate
            - `longitude` string, nullable — Longitude coordinate
            - `isAirportOrAirbase` boolean, required — Whether this location is an airport or airbase
            - `isConstructionOrUtilitySite` boolean, required — Whether this location is a construction or utility site
            - `isSmartyValidated` boolean, required — Whether address has been validated by SmartyStreets
            - `obeysDst` boolean, required — Whether this location observes daylight saving time
            - `cityId` string, uuid, nullable — Reference to standardized city record (internal use)
          - `mcNumber` string, nullable — Motor Carrier (MC) number
          - `dotNumber` string, nullable — Department of Transportation (DOT) number
          - `scac` string, nullable — Standard Carrier Alpha Code
          - `einNumber` string, nullable — Employer Identification Number
          - `ffNumber` string, nullable — Freight Forwarder (FF) number
          - `mxNumber` string, nullable — Mexico carrier registration number
          - `rfcNumber` string, nullable — RFC (Mexico tax ID) number
          - `iataCode` string, nullable — International Air Transport Association code
          - `equipments` CarrierEquipment[] — Equipment types this carrier operates
          - `isHazmat` boolean, nullable — Whether carrier is certified to transport hazardous materials
          - `tsaApproved` boolean, nullable — Whether carrier is TSA approved
          - `trucks` integer, nullable — Number of trucks in fleet
          - `trailers` integer, nullable — Number of trailers in fleet
          - `drivers` integer, nullable — Number of drivers employed
          - `powerUnits` integer, nullable — Number of power units
          - `currency` 'ARS' | 'AUD' | 'BRL' | 'CAD' | 'CNY' | 'EUR' | 'GBP' | 'IDR' | 'INR' | 'JPY' | 'KRW' | 'MXN' | 'RUB' | 'SAR' | 'TRY' | 'USD' | 'ZAR' — Currency code (ISO 4217)
          - `paymentTerm` PaymentTermReference — Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.
            - `id` string, uuid, required — Payment term UUID
            - `key` string, nullable — Client-defined reference ID if set
            - `name` string, required — Payment term name
            - `description` string, nullable — Payment term description or notes
            - `days` integer, nullable — Number of days until payment is due
            - `quickPayFee` number, float, nullable — Quick pay fee percentage (e.g., 0.05 for 5%)
            - `apOnly` boolean, nullable — Whether this payment term is for accounts payable only
            - `doNotUse` boolean, nullable — Flag to prevent using this payment term for new transactions
            - `createdAt` string, date-time, required — When the payment term was created
            - `updatedAt` string, date-time, required — When the payment term was last updated
            - `deletedAt` string, date-time, nullable — When the payment term was soft deleted (null if active)
          - `isFactoringPreferred` boolean, nullable — Whether carrier prefers factoring for payment
          - `goldenCarrierId` string, uuid, nullable — Reference to golden carrier record (for deduplication)
          - `paymentMethods` CarrierPaymentMethodReference[] — Payment methods configured for this carrier
            - `id` string, uuid, required — Unique carrier payment method identifier
            - `key` string, nullable — Client-defined reference identifier
            - `paymentRecipientType` 'DIRECT' | 'FACTOR', required — Who receives the payment. - `DIRECT`: Payment goes directly to the carrier - `FACTOR`: Payment goes to a factoring company (requires carrierFactorId)
            - `paymentMethodType` 'ACH_WIRE' | 'ZELLE' | 'VENMO' | 'ACH' | 'CHECK' | 'WIRE' | 'CAD_EFT' | 'TRIUMPH_PAY' | 'COMCHECK' | 'EFS' | 'ECHECK', required — Payment method type
            - `status` string, nullable — Payment method status
            - `isPreferred` boolean, nullable — Whether this is the preferred payment method
            - `email` string, email, nullable — Email address for payment notifications
            - `phone` string, nullable — Phone number for payment contact
            - `companyName` string, nullable — Company name for this payment method
            - `username` string, nullable — Username for payment platforms
            - `bankName` string, nullable — Bank name
            - `bankAddress` string, nullable — Bank address
            - `accountName` string, nullable — Bank account holder name
            - `accountNumber` string, nullable — Bank account number (masked in responses)
            - `abaAch` string, nullable — ABA/ACH routing number
            - `wire` string, nullable — Wire transfer routing number
            - `swiftCode` string, nullable — SWIFT/BIC code
            - `eftInstitution` string, nullable — EFT institution number (Canadian banking)
            - `eftTransit` string, nullable — EFT transit number (Canadian banking)
            - `clabe` string, nullable — CLABE number (Mexican banking)
            - `currency` string, nullable — Preferred currency code
            - `carrierFactor` CarrierFactorReference — Enhanced reference to a carrier factor (factoring company). Includes full carrier factor details in addition to id/key.
              - …
            - `paymentTerm` PaymentTermReference — Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.
              - …
            - `createdAt` string, date-time, required — When the payment method was created
            - `updatedAt` string, date-time, required — When the payment method was last updated
            - `deletedAt` string, date-time, nullable — When the payment method was soft deleted
            - `deletedBy` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
          - `contacts` CarrierContactReference[] — Contacts for this carrier
            - `object` 'CARRIER_CONTACT' — Object type identifier
            - `id` string, uuid, required — Unique contact identifier
            - `key` string, nullable — Client-defined reference identifier
            - `name` string, required — Contact person's name
            - `contactInfo` ContactInfo, required — Contact information details (nested, without id). This is an embedded object representing a Contact record. The id is managed internally and not exposed in the API.
              - …
            - `contactTypes` CarrierContactType[], nullable — Types/roles this contact serves
            - `invitedUser` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
            - `deletedBy` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
            - `createdAt` string, date-time, required — When the contact was created
            - `deletedAt` string, date-time, nullable — When the contact was soft deleted
          - `createdAt` string, date-time, required — When the carrier was created
          - `updatedAt` string, date-time, required — When the carrier was last updated
          - `deletedAt` string, date-time, nullable — When the carrier was soft deleted (null if active)
        - LtlCarrier — Less-than-truckload (LTL) carrier
          - `object` 'CARRIER' — Object type identifier
          - `id` string, uuid, required — Unique carrier identifier
          - `friendlyId` string, required — Human-readable carrier identifier
          - `type` 'LTL', required — Carrier type discriminator
          - `name` string, required — Carrier legal name
          - `dbaName` string, nullable — Doing Business As name
          - `key` string, nullable — Client-defined reference identifier
          - `email` string, email, nullable — Primary email address
          - `phone` string, nullable — Primary phone number
          - `website` string, nullable — Company website URL
          - `status` string, required — Carrier status
          - `statusReason` string, nullable — Reason for current status
          - `notes` string, nullable — Internal notes about the carrier
          - `corporateAddress` Address — Physical address/location details (nested, without id). This is an embedded object representing a Location record. The id is managed internally and not exposed in the API.
            - `line1` string, required — Primary street address line
            - `line2` string, nullable — Secondary address line (suite, floor, etc.)
            - `city` string, required — City name
            - `country` string, required — Country name or code
            - `market` string, required — Market or region identifier
            - `latitude` string, nullable — Latitude coordinate
            - `longitude` string, nullable — Longitude coordinate
            - `isAirportOrAirbase` boolean, required — Whether this location is an airport or airbase
            - `isConstructionOrUtilitySite` boolean, required — Whether this location is a construction or utility site
            - `isSmartyValidated` boolean, required — Whether address has been validated by SmartyStreets
            - `obeysDst` boolean, required — Whether this location observes daylight saving time
            - `cityId` string, uuid, nullable — Reference to standardized city record (internal use)
          - `billingAddress` Address — Physical address/location details (nested, without id). This is an embedded object representing a Location record. The id is managed internally and not exposed in the API.
            - `line1` string, required — Primary street address line
            - `line2` string, nullable — Secondary address line (suite, floor, etc.)
            - `city` string, required — City name
            - `country` string, required — Country name or code
            - `market` string, required — Market or region identifier
            - `latitude` string, nullable — Latitude coordinate
            - `longitude` string, nullable — Longitude coordinate
            - `isAirportOrAirbase` boolean, required — Whether this location is an airport or airbase
            - `isConstructionOrUtilitySite` boolean, required — Whether this location is a construction or utility site
            - `isSmartyValidated` boolean, required — Whether address has been validated by SmartyStreets
            - `obeysDst` boolean, required — Whether this location observes daylight saving time
            - `cityId` string, uuid, nullable — Reference to standardized city record (internal use)
          - `mcNumber` string, nullable — Motor Carrier (MC) number
          - `dotNumber` string, nullable — Department of Transportation (DOT) number
          - `scac` string, nullable — Standard Carrier Alpha Code
          - `einNumber` string, nullable — Employer Identification Number
          - `ffNumber` string, nullable — Freight Forwarder (FF) number
          - `mxNumber` string, nullable — Mexico carrier registration number
          - `rfcNumber` string, nullable — RFC (Mexico tax ID) number
          - `iataCode` string, nullable — International Air Transport Association code
          - `equipments` CarrierEquipment[] — Equipment types this carrier operates
          - `isHazmat` boolean, nullable — Whether carrier is certified to transport hazardous materials
          - `tsaApproved` boolean, nullable — Whether carrier is TSA approved
          - `trucks` integer, nullable — Number of trucks in fleet
          - `trailers` integer, nullable — Number of trailers in fleet
          - `drivers` integer, nullable — Number of drivers employed
          - `powerUnits` integer, nullable — Number of power units
          - `currency` 'ARS' | 'AUD' | 'BRL' | 'CAD' | 'CNY' | 'EUR' | 'GBP' | 'IDR' | 'INR' | 'JPY' | 'KRW' | 'MXN' | 'RUB' | 'SAR' | 'TRY' | 'USD' | 'ZAR' — Currency code (ISO 4217)
          - `paymentTerm` PaymentTermReference — Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.
            - `id` string, uuid, required — Payment term UUID
            - `key` string, nullable — Client-defined reference ID if set
            - `name` string, required — Payment term name
            - `description` string, nullable — Payment term description or notes
            - `days` integer, nullable — Number of days until payment is due
            - `quickPayFee` number, float, nullable — Quick pay fee percentage (e.g., 0.05 for 5%)
            - `apOnly` boolean, nullable — Whether this payment term is for accounts payable only
            - `doNotUse` boolean, nullable — Flag to prevent using this payment term for new transactions
            - `createdAt` string, date-time, required — When the payment term was created
            - `updatedAt` string, date-time, required — When the payment term was last updated
            - `deletedAt` string, date-time, nullable — When the payment term was soft deleted (null if active)
          - `isFactoringPreferred` boolean, nullable — Whether carrier prefers factoring for payment
          - `goldenCarrierId` string, uuid, nullable — Reference to golden carrier record (for deduplication)
          - `paymentMethods` CarrierPaymentMethodReference[] — Payment methods configured for this carrier
            - `id` string, uuid, required — Unique carrier payment method identifier
            - `key` string, nullable — Client-defined reference identifier
            - `paymentRecipientType` 'DIRECT' | 'FACTOR', required — Who receives the payment. - `DIRECT`: Payment goes directly to the carrier - `FACTOR`: Payment goes to a factoring company (requires carrierFactorId)
            - `paymentMethodType` 'ACH_WIRE' | 'ZELLE' | 'VENMO' | 'ACH' | 'CHECK' | 'WIRE' | 'CAD_EFT' | 'TRIUMPH_PAY' | 'COMCHECK' | 'EFS' | 'ECHECK', required — Payment method type
            - `status` string, nullable — Payment method status
            - `isPreferred` boolean, nullable — Whether this is the preferred payment method
            - `email` string, email, nullable — Email address for payment notifications
            - `phone` string, nullable — Phone number for payment contact
            - `companyName` string, nullable — Company name for this payment method
            - `username` string, nullable — Username for payment platforms
            - `bankName` string, nullable — Bank name
            - `bankAddress` string, nullable — Bank address
            - `accountName` string, nullable — Bank account holder name
            - `accountNumber` string, nullable — Bank account number (masked in responses)
            - `abaAch` string, nullable — ABA/ACH routing number
            - `wire` string, nullable — Wire transfer routing number
            - `swiftCode` string, nullable — SWIFT/BIC code
            - `eftInstitution` string, nullable — EFT institution number (Canadian banking)
            - `eftTransit` string, nullable — EFT transit number (Canadian banking)
            - `clabe` string, nullable — CLABE number (Mexican banking)
            - `currency` string, nullable — Preferred currency code
            - `carrierFactor` CarrierFactorReference — Enhanced reference to a carrier factor (factoring company). Includes full carrier factor details in addition to id/key.
              - …
            - `paymentTerm` PaymentTermReference — Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.
              - …
            - `createdAt` string, date-time, required — When the payment method was created
            - `updatedAt` string, date-time, required — When the payment method was last updated
            - `deletedAt` string, date-time, nullable — When the payment method was soft deleted
            - `deletedBy` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
          - `contacts` CarrierContactReference[] — Contacts for this carrier
            - `object` 'CARRIER_CONTACT' — Object type identifier
            - `id` string, uuid, required — Unique contact identifier
            - `key` string, nullable — Client-defined reference identifier
            - `name` string, required — Contact person's name
            - `contactInfo` ContactInfo, required — Contact information details (nested, without id). This is an embedded object representing a Contact record. The id is managed internally and not exposed in the API.
              - …
            - `contactTypes` CarrierContactType[], nullable — Types/roles this contact serves
            - `invitedUser` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
            - `deletedBy` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
            - `createdAt` string, date-time, required — When the contact was created
            - `deletedAt` string, date-time, nullable — When the contact was soft deleted
          - `createdAt` string, date-time, required — When the carrier was created
          - `updatedAt` string, date-time, required — When the carrier was last updated
          - `deletedAt` string, date-time, nullable — When the carrier was soft deleted (null if active)
        - OceanCarrier — Ocean freight carrier
          - `object` 'CARRIER' — Object type identifier
          - `id` string, uuid, required — Unique carrier identifier
          - `friendlyId` string, required — Human-readable carrier identifier
          - `type` 'OCEAN', required — Carrier type discriminator
          - `name` string, required — Carrier legal name
          - `dbaName` string, nullable — Doing Business As name
          - `key` string, nullable — Client-defined reference identifier
          - `email` string, email, nullable — Primary email address
          - `phone` string, nullable — Primary phone number
          - `website` string, nullable — Company website URL
          - `status` string, required — Carrier status
          - `statusReason` string, nullable — Reason for current status
          - `notes` string, nullable — Internal notes about the carrier
          - `corporateAddress` Address — Physical address/location details (nested, without id). This is an embedded object representing a Location record. The id is managed internally and not exposed in the API.
            - `line1` string, required — Primary street address line
            - `line2` string, nullable — Secondary address line (suite, floor, etc.)
            - `city` string, required — City name
            - `country` string, required — Country name or code
            - `market` string, required — Market or region identifier
            - `latitude` string, nullable — Latitude coordinate
            - `longitude` string, nullable — Longitude coordinate
            - `isAirportOrAirbase` boolean, required — Whether this location is an airport or airbase
            - `isConstructionOrUtilitySite` boolean, required — Whether this location is a construction or utility site
            - `isSmartyValidated` boolean, required — Whether address has been validated by SmartyStreets
            - `obeysDst` boolean, required — Whether this location observes daylight saving time
            - `cityId` string, uuid, nullable — Reference to standardized city record (internal use)
          - `billingAddress` Address — Physical address/location details (nested, without id). This is an embedded object representing a Location record. The id is managed internally and not exposed in the API.
            - `line1` string, required — Primary street address line
            - `line2` string, nullable — Secondary address line (suite, floor, etc.)
            - `city` string, required — City name
            - `country` string, required — Country name or code
            - `market` string, required — Market or region identifier
            - `latitude` string, nullable — Latitude coordinate
            - `longitude` string, nullable — Longitude coordinate
            - `isAirportOrAirbase` boolean, required — Whether this location is an airport or airbase
            - `isConstructionOrUtilitySite` boolean, required — Whether this location is a construction or utility site
            - `isSmartyValidated` boolean, required — Whether address has been validated by SmartyStreets
            - `obeysDst` boolean, required — Whether this location observes daylight saving time
            - `cityId` string, uuid, nullable — Reference to standardized city record (internal use)
          - `mcNumber` string, nullable — Motor Carrier (MC) number
          - `dotNumber` string, nullable — Department of Transportation (DOT) number
          - `scac` string, nullable — Standard Carrier Alpha Code
          - `einNumber` string, nullable — Employer Identification Number
          - `ffNumber` string, nullable — Freight Forwarder (FF) number
          - `mxNumber` string, nullable — Mexico carrier registration number
          - `rfcNumber` string, nullable — RFC (Mexico tax ID) number
          - `iataCode` string, nullable — International Air Transport Association code
          - `equipments` CarrierEquipment[] — Equipment types this carrier operates
          - `isHazmat` boolean, nullable — Whether carrier is certified to transport hazardous materials
          - `tsaApproved` boolean, nullable — Whether carrier is TSA approved
          - `trucks` integer, nullable — Number of trucks in fleet
          - `trailers` integer, nullable — Number of trailers in fleet
          - `drivers` integer, nullable — Number of drivers employed
          - `powerUnits` integer, nullable — Number of power units
          - `currency` 'ARS' | 'AUD' | 'BRL' | 'CAD' | 'CNY' | 'EUR' | 'GBP' | 'IDR' | 'INR' | 'JPY' | 'KRW' | 'MXN' | 'RUB' | 'SAR' | 'TRY' | 'USD' | 'ZAR' — Currency code (ISO 4217)
          - `paymentTerm` PaymentTermReference — Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.
            - `id` string, uuid, required — Payment term UUID
            - `key` string, nullable — Client-defined reference ID if set
            - `name` string, required — Payment term name
            - `description` string, nullable — Payment term description or notes
            - `days` integer, nullable — Number of days until payment is due
            - `quickPayFee` number, float, nullable — Quick pay fee percentage (e.g., 0.05 for 5%)
            - `apOnly` boolean, nullable — Whether this payment term is for accounts payable only
            - `doNotUse` boolean, nullable — Flag to prevent using this payment term for new transactions
            - `createdAt` string, date-time, required — When the payment term was created
            - `updatedAt` string, date-time, required — When the payment term was last updated
            - `deletedAt` string, date-time, nullable — When the payment term was soft deleted (null if active)
          - `isFactoringPreferred` boolean, nullable — Whether carrier prefers factoring for payment
          - `goldenCarrierId` string, uuid, nullable — Reference to golden carrier record (for deduplication)
          - `paymentMethods` CarrierPaymentMethodReference[] — Payment methods configured for this carrier
            - `id` string, uuid, required — Unique carrier payment method identifier
            - `key` string, nullable — Client-defined reference identifier
            - `paymentRecipientType` 'DIRECT' | 'FACTOR', required — Who receives the payment. - `DIRECT`: Payment goes directly to the carrier - `FACTOR`: Payment goes to a factoring company (requires carrierFactorId)
            - `paymentMethodType` 'ACH_WIRE' | 'ZELLE' | 'VENMO' | 'ACH' | 'CHECK' | 'WIRE' | 'CAD_EFT' | 'TRIUMPH_PAY' | 'COMCHECK' | 'EFS' | 'ECHECK', required — Payment method type
            - `status` string, nullable — Payment method status
            - `isPreferred` boolean, nullable — Whether this is the preferred payment method
            - `email` string, email, nullable — Email address for payment notifications
            - `phone` string, nullable — Phone number for payment contact
            - `companyName` string, nullable — Company name for this payment method
            - `username` string, nullable — Username for payment platforms
            - `bankName` string, nullable — Bank name
            - `bankAddress` string, nullable — Bank address
            - `accountName` string, nullable — Bank account holder name
            - `accountNumber` string, nullable — Bank account number (masked in responses)
            - `abaAch` string, nullable — ABA/ACH routing number
            - `wire` string, nullable — Wire transfer routing number
            - `swiftCode` string, nullable — SWIFT/BIC code
            - `eftInstitution` string, nullable — EFT institution number (Canadian banking)
            - `eftTransit` string, nullable — EFT transit number (Canadian banking)
            - `clabe` string, nullable — CLABE number (Mexican banking)
            - `currency` string, nullable — Preferred currency code
            - `carrierFactor` CarrierFactorReference — Enhanced reference to a carrier factor (factoring company). Includes full carrier factor details in addition to id/key.
              - …
            - `paymentTerm` PaymentTermReference — Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.
              - …
            - `createdAt` string, date-time, required — When the payment method was created
            - `updatedAt` string, date-time, required — When the payment method was last updated
            - `deletedAt` string, date-time, nullable — When the payment method was soft deleted
            - `deletedBy` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
          - `contacts` CarrierContactReference[] — Contacts for this carrier
            - `object` 'CARRIER_CONTACT' — Object type identifier
            - `id` string, uuid, required — Unique contact identifier
            - `key` string, nullable — Client-defined reference identifier
            - `name` string, required — Contact person's name
            - `contactInfo` ContactInfo, required — Contact information details (nested, without id). This is an embedded object representing a Contact record. The id is managed internally and not exposed in the API.
              - …
            - `contactTypes` CarrierContactType[], nullable — Types/roles this contact serves
            - `invitedUser` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
            - `deletedBy` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
            - `createdAt` string, date-time, required — When the contact was created
            - `deletedAt` string, date-time, nullable — When the contact was soft deleted
          - `createdAt` string, date-time, required — When the carrier was created
          - `updatedAt` string, date-time, required — When the carrier was last updated
          - `deletedAt` string, date-time, nullable — When the carrier was soft deleted (null if active)
        - RailCarrier — Rail freight carrier
          - `object` 'CARRIER' — Object type identifier
          - `id` string, uuid, required — Unique carrier identifier
          - `friendlyId` string, required — Human-readable carrier identifier
          - `type` 'RAIL', required — Carrier type discriminator
          - `name` string, required — Carrier legal name
          - `dbaName` string, nullable — Doing Business As name
          - `key` string, nullable — Client-defined reference identifier
          - `email` string, email, nullable — Primary email address
          - `phone` string, nullable — Primary phone number
          - `website` string, nullable — Company website URL
          - `status` string, required — Carrier status
          - `statusReason` string, nullable — Reason for current status
          - `notes` string, nullable — Internal notes about the carrier
          - `corporateAddress` Address — Physical address/location details (nested, without id). This is an embedded object representing a Location record. The id is managed internally and not exposed in the API.
            - `line1` string, required — Primary street address line
            - `line2` string, nullable — Secondary address line (suite, floor, etc.)
            - `city` string, required — City name
            - `country` string, required — Country name or code
            - `market` string, required — Market or region identifier
            - `latitude` string, nullable — Latitude coordinate
            - `longitude` string, nullable — Longitude coordinate
            - `isAirportOrAirbase` boolean, required — Whether this location is an airport or airbase
            - `isConstructionOrUtilitySite` boolean, required — Whether this location is a construction or utility site
            - `isSmartyValidated` boolean, required — Whether address has been validated by SmartyStreets
            - `obeysDst` boolean, required — Whether this location observes daylight saving time
            - `cityId` string, uuid, nullable — Reference to standardized city record (internal use)
          - `billingAddress` Address — Physical address/location details (nested, without id). This is an embedded object representing a Location record. The id is managed internally and not exposed in the API.
            - `line1` string, required — Primary street address line
            - `line2` string, nullable — Secondary address line (suite, floor, etc.)
            - `city` string, required — City name
            - `country` string, required — Country name or code
            - `market` string, required — Market or region identifier
            - `latitude` string, nullable — Latitude coordinate
            - `longitude` string, nullable — Longitude coordinate
            - `isAirportOrAirbase` boolean, required — Whether this location is an airport or airbase
            - `isConstructionOrUtilitySite` boolean, required — Whether this location is a construction or utility site
            - `isSmartyValidated` boolean, required — Whether address has been validated by SmartyStreets
            - `obeysDst` boolean, required — Whether this location observes daylight saving time
            - `cityId` string, uuid, nullable — Reference to standardized city record (internal use)
          - `mcNumber` string, nullable — Motor Carrier (MC) number
          - `dotNumber` string, nullable — Department of Transportation (DOT) number
          - `scac` string, nullable — Standard Carrier Alpha Code
          - `einNumber` string, nullable — Employer Identification Number
          - `ffNumber` string, nullable — Freight Forwarder (FF) number
          - `mxNumber` string, nullable — Mexico carrier registration number
          - `rfcNumber` string, nullable — RFC (Mexico tax ID) number
          - `iataCode` string, nullable — International Air Transport Association code
          - `equipments` CarrierEquipment[] — Equipment types this carrier operates
          - `isHazmat` boolean, nullable — Whether carrier is certified to transport hazardous materials
          - `tsaApproved` boolean, nullable — Whether carrier is TSA approved
          - `trucks` integer, nullable — Number of trucks in fleet
          - `trailers` integer, nullable — Number of trailers in fleet
          - `drivers` integer, nullable — Number of drivers employed
          - `powerUnits` integer, nullable — Number of power units
          - `currency` 'ARS' | 'AUD' | 'BRL' | 'CAD' | 'CNY' | 'EUR' | 'GBP' | 'IDR' | 'INR' | 'JPY' | 'KRW' | 'MXN' | 'RUB' | 'SAR' | 'TRY' | 'USD' | 'ZAR' — Currency code (ISO 4217)
          - `paymentTerm` PaymentTermReference — Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.
            - `id` string, uuid, required — Payment term UUID
            - `key` string, nullable — Client-defined reference ID if set
            - `name` string, required — Payment term name
            - `description` string, nullable — Payment term description or notes
            - `days` integer, nullable — Number of days until payment is due
            - `quickPayFee` number, float, nullable — Quick pay fee percentage (e.g., 0.05 for 5%)
            - `apOnly` boolean, nullable — Whether this payment term is for accounts payable only
            - `doNotUse` boolean, nullable — Flag to prevent using this payment term for new transactions
            - `createdAt` string, date-time, required — When the payment term was created
            - `updatedAt` string, date-time, required — When the payment term was last updated
            - `deletedAt` string, date-time, nullable — When the payment term was soft deleted (null if active)
          - `isFactoringPreferred` boolean, nullable — Whether carrier prefers factoring for payment
          - `goldenCarrierId` string, uuid, nullable — Reference to golden carrier record (for deduplication)
          - `paymentMethods` CarrierPaymentMethodReference[] — Payment methods configured for this carrier
            - `id` string, uuid, required — Unique carrier payment method identifier
            - `key` string, nullable — Client-defined reference identifier
            - `paymentRecipientType` 'DIRECT' | 'FACTOR', required — Who receives the payment. - `DIRECT`: Payment goes directly to the carrier - `FACTOR`: Payment goes to a factoring company (requires carrierFactorId)
            - `paymentMethodType` 'ACH_WIRE' | 'ZELLE' | 'VENMO' | 'ACH' | 'CHECK' | 'WIRE' | 'CAD_EFT' | 'TRIUMPH_PAY' | 'COMCHECK' | 'EFS' | 'ECHECK', required — Payment method type
            - `status` string, nullable — Payment method status
            - `isPreferred` boolean, nullable — Whether this is the preferred payment method
            - `email` string, email, nullable — Email address for payment notifications
            - `phone` string, nullable — Phone number for payment contact
            - `companyName` string, nullable — Company name for this payment method
            - `username` string, nullable — Username for payment platforms
            - `bankName` string, nullable — Bank name
            - `bankAddress` string, nullable — Bank address
            - `accountName` string, nullable — Bank account holder name
            - `accountNumber` string, nullable — Bank account number (masked in responses)
            - `abaAch` string, nullable — ABA/ACH routing number
            - `wire` string, nullable — Wire transfer routing number
            - `swiftCode` string, nullable — SWIFT/BIC code
            - `eftInstitution` string, nullable — EFT institution number (Canadian banking)
            - `eftTransit` string, nullable — EFT transit number (Canadian banking)
            - `clabe` string, nullable — CLABE number (Mexican banking)
            - `currency` string, nullable — Preferred currency code
            - `carrierFactor` CarrierFactorReference — Enhanced reference to a carrier factor (factoring company). Includes full carrier factor details in addition to id/key.
              - …
            - `paymentTerm` PaymentTermReference — Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.
              - …
            - `createdAt` string, date-time, required — When the payment method was created
            - `updatedAt` string, date-time, required — When the payment method was last updated
            - `deletedAt` string, date-time, nullable — When the payment method was soft deleted
            - `deletedBy` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
          - `contacts` CarrierContactReference[] — Contacts for this carrier
            - `object` 'CARRIER_CONTACT' — Object type identifier
            - `id` string, uuid, required — Unique contact identifier
            - `key` string, nullable — Client-defined reference identifier
            - `name` string, required — Contact person's name
            - `contactInfo` ContactInfo, required — Contact information details (nested, without id). This is an embedded object representing a Contact record. The id is managed internally and not exposed in the API.
              - …
            - `contactTypes` CarrierContactType[], nullable — Types/roles this contact serves
            - `invitedUser` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
            - `deletedBy` UserReference — Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (teams, etc.) to prevent recursion. Maximum nesting depth: 1 level.
              - …
            - `createdAt` string, date-time, required — When the contact was created
            - `deletedAt` string, date-time, nullable — When the contact was soft deleted
          - `createdAt` string, date-time, required — When the carrier was created
          - `updatedAt` string, date-time, required — When the carrier was last updated
          - `deletedAt` string, date-time, nullable — When the carrier was soft deleted (null if active)
  - `pagination` SearchPaginationInfo, required — Pagination information for search results
    - `pageNumber` integer, required — Current page number
    - `pageSize` integer, required — Number of results returned on this page
    - `totalPages` integer, required — Total number of pages available
  - `totalResults` integer, required — Total number of matching results (excluding soft-deleted records)

## Other responses

- `400` — Bad request - invalid input
- `401` — Unauthorized - invalid or missing access token
- `422` — Validation error - invalid field values
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/mvmnt/apis/mvmnt-api.md) · [All operations](https://skmtc.net/mvmnt/apis/mvmnt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mvmnt/mvmnt-api/revisions/c44e5e7a4256/schema)