Filter saved searches

Changed on Oct 7, 2026

Filter saved searches using comprehensive query criteria with AND/OR logic and multiple operators. Supports complex filtering similar to GraphQL capabilities. Returns only saved searches accessible to the authenticated user (either owned by them or public).

post/saved-searches/filter

Request

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

Request body

pageSizeinteger

Number of results per page

cursorstring

Pagination cursor for next page

Example request

{
  "filter": {
    "preferenceType": {
      "equalTo": "SHIPMENT"
    },
    "isPublic": {
      "equalTo": true
    }
  },
  "pageSize": 50
}

Response

Successful response

Example response

{
  "data": [
    {
      "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"
    }
  ],
  "pagination": {
    "pageSize": 50,
    "hasNextPage": true,
    "endCursor": "eyJpZCI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAwMCJ9"
  },
  "errors": [
    {
      "field": "/required",
      "message": "missing property 'status'"
    }
  ]
}

Changes

Oct 7, 20262cd6ecfbeb82 Revision changes
- breaking
  the response's body type changed from object to no type for 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
- 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
  added subschema #2 to the response body allOf list 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
  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 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