Bill Payments8

Bills11

Carrier Contacts5

Carrier Factors6

Carrier Payment Methods5

Carriers8

Companies5

Credit Memos8

Customer Contacts5

Customers8

Documents20

Invoices11

Loads13

Location Contacts5

Locations6

Payment Terms5

Payments6

Quotes6

Reference Data3

Saved Searches5

Search1

Services5

Shipments16

Stops5

Teams5

Users6

Vendor Contacts5

Vendor Payment Methods5

Vendors8

Webhooks

Event Notifications1

Saved Searches

Get saved search

Changed on Oct 7, 2026

Retrieve a saved search by ID. You can only retrieve saved searches that you own or that are public in your organization.

get/saved-searches/{id}

Request

Base URL: https://api.mvmnt.io/v1
URL: https://api.mvmnt.io/v1/saved-searches/{id}
Auth: HTTP bearer

Path parameters

idstring uuid required

Saved search UUID

Response

Successful response

object'SAVED_SEARCH'

Object type identifier

idstring uuid required

Unique saved search identifier

namestring required

Display name for the saved search

Type of entity this saved search applies to. Each type corresponds to a specific entity's search view.

Entity Mapping:

INVOICE: Customer invoices (AR Invoices) - money owed to you
BILL: Vendor/Carrier bills (AP Invoices) - money you owe
INVOICE_PAYMENT: Customer payment groups (AR Payment Groups)
BILL_PAYMENT: Vendor/Carrier payment groups (AP Payment Groups)

isPublicboolean nullable

Whether this saved search is visible to all users in the organization. If false or null, only the owner can see it.

ownedByUserstring uuid nullable

User ID who owns this saved search. Null means it's an organization-level saved search.

groupIdstring uuid nullable

Optional group this saved search belongs to

createdAtstring date-time required

Timestamp when saved search was created

updatedAtstring date-time required

Timestamp when saved search was last updated

Example response

{
  "object": "SAVED_SEARCH",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Active Shipments - West Coast",
  "preferenceType": "SHIPMENT",
  "jsonValue": {
    "searchCriteria": {
      "filters": [
        {
          "field": "status",
          "searchCriteria": {
            "operator": "ONE_OF",
            "values": [
              "ACTIVE",
              "PENDING"
            ]
          }
        }
      ]
    },
    "sorting": [
      {
        "id": "createdAt",
        "desc": true
      }
    ],
    "columnVisibility": {
      "status": true,
      "createdAt": true
    },
    "columnOrder": [
      "id",
      "status",
      "createdAt"
    ]
  },
  "isPublic": true,
  "ownedByUser": "550e8400-e29b-41d4-a716-446655440001",
  "createdAt": "2025-01-15T10:00:00Z",
  "updatedAt": "2025-01-15T14:30:00Z"
}

Changes

Oct 7, 20262cd6ecfbeb82 Revision changes
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- warning
  the optional response header X-RateLimit-Reset removed for the status 429
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
Aug 15, 2026ce0e9003047c Revision changes
- warning
  added the new AP_CREDIT_MEMO enum value to the //// response property for the response status
- warning
  added the new AR_CREDIT_MEMO enum value to the //// response property for the response status
- warning
  added the new CARRIER_FACTOR enum value to the //// response property for the response status
- warning
  added the new COMMISSION_PAYMENT enum value to the //// response property for the response status

Operation history