List actions for your listings

GET

https://api.pricelabs.co/v1/actions

GET

/v1/actions

$ curl https://api.pricelabs.co/v1/actions \
>      -H "X-API-Key: {{API_KEY}}"

1 [
2   {
3     "listing_details": {
4       "listing_id": "10000001",
5       "pms": "airbnb",
6       "pms_display_name": "Airbnb",
7       "listing_name": "Cozy Downtown Apartment"
8     },
9     "actions": [
10       {
11         "action_type": "base_price_alert",
12         "title": "New Base Price Recommendation",
13         "metadata": {
14           "nudge_id": "550e8400-e29b-41d4-a716-446655440000",
15           "current": {
16             "price": 100
17           },
18           "recommended": {
19             "price": 120
20           },
21           "direction": "increase",
22           "expiration": "2026-08-10T00:00:00.000Z"
23         }
24       },
25       {
26         "action_type": "minimum_stay_off_vs_market",
27         "title": "Minimum Stays Don't Match the Market",
28         "metadata": {
29           "current": {
30             "weekday_min_stay": 30,
31             "weekend_min_stay": 20
32           },
33           "recommended": {
34             "weekday_min_stay": 3,
35             "weekend_min_stay": 3
36           }
37         }
38       },
39       {
40         "action_type": "many_blocked_dates",
41         "title": "Many Blocked Dates",
42         "metadata": {
43           "count": 27,
44           "threshold": 3,
45           "date_ranges": [
46             {
47               "start": "2026-09-08",
48               "end": "2026-09-09",
49               "days": 2
50             }
51           ]
52         }
53       }
54     ]
55   },
56   {
57     "listing_details": {
58       "listing_id": "10000002",
59       "pms": "vrbo",
60       "pms_display_name": "Vrbo",
61       "listing_name": "Beach House"
62     },
63     "actions": [
64       {
65         "action_type": "location_missing",
66         "title": "Missing Location",
67         "metadata": {}
68       }
69     ]
70   }
71 ]

Returns the Action Center alerts and recommendations for your listings: missing listing information, configuration issues, availability alerts, and pricing recommendations.

Grouped per listing, most important first. Listings with nothing flagged are omitted, so the array can be empty.

Query parameters

listing_idstringOptional

Restrict to this listing. Must be provided together with pms.

pmsstringOptional

PMS name of the listing. Must be provided together with listing_id. Omit both to return actions for every accessible listing.

modeenumOptionalDefaults to visible

How the account’s action visibility preferences are applied. visible (default) returns only actions that are not hidden, all ignores preferences, and hidden returns only the actions that have been hidden.

Allowed values:

Response

One entry per listing that has at least one active action (may be empty)

listing_detailsobjectOptional

actionslist of objectsOptional

Ordered most important first.

Errors

400

Bad Request Error

404

Not Found Error

Headers

Query parameters

Response

Errors