# Get listing alert

**GET /listing-alerts/{id}**

One listing alert: who it is for, its type, its email_settings (mode and schedule, with the settings of whichever mode it is in), its criteria as the sentence the agent app shows, and how many of its results sit in each of the agent app's tabs (unsent, sent, trashed).

Requires the `listing_alerts:read` scope. Rate budget: 300 calls per 1 minute per credential (the `read` class).


## Servers
- https://www.realscout.com/api/agent/v1: https://www.realscout.com/api/agent/v1 ()


## Authentication methods
- Bearer auth


## Parameters

### Path parameters

- **id** (string)
  The listing alert id.




## Responses
### 200
OK
#### Headers

- **X-RateLimit-Limit** (integer)
  Calls allowed in the current window.

- **X-RateLimit-Remaining** (integer)
  Calls left in the current window.

- **X-RateLimit-Reset** (integer)
  Epoch seconds at which the window resets.


#### Body: application/json (object)
- **id** (string)

- **name** (string | null)

- **contact** (object | null)

- **search_type** (string | null)

- **email_settings** (object)

- **last_ran_at** (string(date-time) | null)

- **sunset** (boolean | null)

- **source** (string | null)

- **created_at** (string(date-time) | null)

- **updated_at** (string(date-time) | null)

- **realscout_url** (string(uri) | null)

- **description** (string | null)

- **criteria_summary** (string | null)

- **results** (object | null)


### 400
The request is invalid; `field` names the offending input when there is one. A body that is not valid JSON is refused before the API runs, as a bare 400 with no body.

#### Body: application/json (object)
- **error** (object)


### 401
Invalid or missing bearer token.

#### Body: application/json (object)
- **error** (object)


### 403
The credential was not granted the scope this call requires.

#### Body: application/json (object)
- **error** (object)


### 404
Not found, or not yours: the two are indistinguishable on purpose.

#### Body: application/json (object)
- **error** (object)


### 429
Rate limit exceeded; `Retry-After` says when to try again.
#### Headers

- **Retry-After** (integer)
  Seconds until the budget refills.


#### Body: application/json (object)
- **error** (object)


### 500
Something went wrong on our side.

#### Body: application/json (object)
- **error** (object)



[Powered by Bump.sh](https://bump.sh)