v1

latestOpenAPI 3.1.0Proprietary2026-08-06177398877.4 KB
Carrier Payment Methods

Filter carrier payment methods

Query carrier payment methods using flexible filter criteria with AND/OR logic.

By default, only non-deleted payment methods are returned (deletedAt: { isNull: true }). Override this by explicitly setting deletedAt filter criteria.

Carrier payment methods define how and where payments are sent for a specific carrier.

post/carrier-payment-methods/filter

Request body

pageSizeinteger

Number of results per page

cursorstring

Pagination cursor for next page

Example request

{
  "filter": {
    "and": [
      {
        "carrierId": {
          "equalTo": "770e8400-e29b-41d4-a716-446655440000"
        }
      },
      {
        "paymentRecipientType": {
          "equalTo": "DIRECT"
        }
      },
      {
        "isPreferred": {
          "equalTo": true
        }
      }
    ]
  },
  "pageSize": 50
}

Response

Filtered carrier payment methods with pagination

Example response

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "carrierId": "770e8400-e29b-41d4-a716-446655440000",
      "carrier": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "key": "ERP-CARRIER-SWIFT",
        "name": "Swift Transportation",
        "phoneNumber": "+1-555-987-6543",
        "email": "dispatch@swifttrans.com",
        "createdAt": "2025-01-15T10:00:00Z",
        "updatedAt": "2025-01-15T14:30:00Z"
      },
      "paymentRecipientType": "DIRECT",
      "paymentMethodType": "ACH",
      "status": "ACTIVE",
      "isPreferred": true,
      "email": "payments@carrier.com",
      "phone": "+1-555-123-4567",
      "companyName": "Carrier Payments LLC",
      "username": "carrier_payments",
      "bankName": "Chase Bank",
      "bankAddress": "123 Bank Street, Dallas, TX 75201",
      "accountName": "Carrier Transport Inc",
      "accountNumber": "****1234",
      "abaAch": "021000021",
      "wire": "026009593",
      "swiftCode": "CHASUS33",
      "eftInstitution": "001",
      "eftTransit": "00010",
      "clabe": "012180001234567897",
      "currency": "USD",
      "carrierFactor": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "key": "ERP-FACTOR-001",
        "companyName": "Capital Factoring Services Inc",
        "email": "accounting@capitalfactoring.com",
        "phoneNumber": "+1-555-234-5678",
        "currency": "USD",
        "createdAt": "2025-01-15T10:00:00Z",
        "updatedAt": "2025-01-15T14:30:00Z"
      },
      "paymentTerm": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "key": "ERP-PAYTERM-NET30",
        "name": "Net 30",
        "description": "Payment due 30 days from invoice date",
        "days": 30,
        "quickPayFee": 0.05,
        "createdAt": "2025-01-15T10:00:00Z",
        "updatedAt": "2025-01-15T14:30:00Z"
      },
      "createdAt": "2025-01-15T10:00:00Z",
      "updatedAt": "2025-01-15T14:30:00Z",
      "deletedBy": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "key": "ERP-USER-12345",
        "email": "john.doe@example.com",
        "name": "John Doe",
        "phone": "+1-555-123-4567",
        "phoneExt": "123",
        "status": "ACTIVE",
        "avatarId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "createdAt": "2025-01-15T10:00:00Z",
        "updatedAt": "2025-01-15T14:30:00Z"
      }
    }
  ],
  "pageInfo": {
    "pageSize": 50,
    "hasNextPage": true,
    "endCursor": "eyJpZCI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAwMCJ9"
  }
}