GET
/
v2
/
views
/
{view_id}
Get a saved filter view
curl --request GET \
  --url https://api-v2.watchcollect.com/v2/views/{view_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "filters": {
    "side": [
      "for_sale"
    ],
    "brand": [
      "Rolex"
    ],
    "reference": [
      "126610LN"
    ],
    "country_codes": {
      "include": [
        "31"
      ]
    },
    "phone_numbers_exclude": [
      "85212345678"
    ],
    "price": {
      "lte": 1200000,
      "currency": "EUR"
    },
    "message_timestamp_ms": {
      "gte": 1777800000000
    }
  },
  "sort": [
    {
      "field": "message_timestamp_ms",
      "direction": "desc"
    }
  ],
  "is_system": true,
  "created_at_ms": 123,
  "updated_at_ms": 123,
  "tab_key": "<string>",
  "display_order": 123,
  "created_by": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
view_id
string<uuid>
required

Response

The saved view.

​
id
string<uuid>
required
​
name
string
required
​
filters
object
required

Universal saved-view filter grammar. Each application surface applies the filters it understands.

Example:
{
  "side": ["for_sale"],
  "brand": ["Rolex"],
  "reference": ["126610LN"],
  "country_codes": { "include": ["31"] },
  "phone_numbers_exclude": ["85212345678"],
  "price": { "lte": 1200000, "currency": "EUR" },
  "message_timestamp_ms": { "gte": 1777800000000 }
}
​
sort
object[]
required

Ordered sort clauses for a saved view.

Example:
[
  {
    "field": "message_timestamp_ms",
    "direction": "desc"
  }
]
​
projection
enum<string>
required

Response projection requested by a saved view.

Available options:
message_card,
market_listing_card,
contact_profile_card
​
is_system
boolean
required
​
created_at_ms
integer<int64>
required
​
updated_at_ms
integer<int64>
required
​
tab_key
string | null
​
display_order
integer | null
​
created_by
string | null