---
title: "List Active Monitors - API Reference"
description: "API endpoint to list all active Twitter/X monitors on your account, with their type, target and webhook configuration."
source: "https://docs.socialdata.tools/monitoring/list-active-monitors/"
---

Returns a list of monitors owned by the user, newest first.

Both active and paused monitors are returned — check each monitor’s `status` field to tell them apart. A monitor is paused when a charge could not be collected from your balance; it stops checking for updates until you top up, then resumes automatically. See [Pricing](https://docs.socialdata.tools/monitoring/pricing/#running-out-of-balance).

GET https://api.socialdata.tools/monitors?page={page}

## Headers

**Authorization** `string` — required

Authorization Bearer header containing your SocialData API key

Example: Bearer YOUR\_API\_KEY

## Query Parameters

**page** `integer` — optional

Page number

Example: 2

**per\_page** `integer` — optional

Monitors returned per page. Values above 50 are capped at 50

Example: 50

## Code Examples

#### curl

```shellscript
curl "https://api.socialdata.tools/monitors" \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -H 'Accept: application/json'
```

#### JavaScript

```js
const API_KEY = 'YOUR_API_KEY_HERE';

fetch('https://api.socialdata.tools/monitors', {
    method: 'GET',
    headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Accept': 'application/json'
    }
})
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
```

#### Python

```python
import requests

API_KEY = 'YOUR_API_KEY_HERE'

url = 'https://api.socialdata.tools/monitors'

headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Accept': 'application/json'
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Error: {response.status_code}")
    print(response.text)
```

#### PHP

```php
$API_KEY = 'YOUR_API_KEY_HERE';

$url = "https://api.socialdata.tools/monitors";

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $API_KEY",
        "Accept: application/json"
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);

curl_close($ch);
```

## Example Responses

#### 200

```json
{
  "data": [
    {
      "id": "01jhfkd7xsvy6afdmwycs1qn61",
      "created_at": "2025-01-13T15:30:02.000000Z",
      "monitor_type": "user_following",
      "status": "active",
      "webhook_url": null,
      "parameters": {
        "user_screen_name": "elonmusk",
        "user_name": "Elon Musk",
        "user_id_str": "44196397"
      }
    },
    {
      "id": "01jhfkdcmt0d8fjbbxqrtqbmck",
      "created_at": "2025-01-13T15:30:07.000000Z",
      "monitor_type": "user_tweets",
      "status": "paused",
      "webhook_url": null,
      "parameters": {
        "user_screen_name": "elonmusk",
        "user_name": "Elon Musk",
        "user_id_str": "44196397"
      }
    },
    {
      "id": "01jqty3m3dhg9xpsj373x12ck7",
      "created_at": "2025-01-13T15:31:22.000000Z",
      "monitor_type": "search_keyword",
      "status": "active",
      "webhook_url": "https://my-website.com/webhook",
      "parameters": {
        "query": "from:elonmusk doge"
      },
      "refresh_frequency": 300
    },
        // ...
  ],
  "meta": {
    "page": 1,
    "last_page": 2,
    "items_count": 100
  }
}
```

#### 402

```json
{
    "status": "error",
    "message": "Insufficient balance"
}
```

#### 404

```json
{
    "status": "error",
    "message": "Not found"
}
```

#### 500

```json
{
    "status": "error",
    "message": "Failed to fetch data from Twitter"
}
```

## Response Codes

-   **200 OK** - request succeeded
-   **404 Not Found** - requested tweet does not exist
-   **500 Internal Error** - API internal error, typically means that SocialData API failed to obtain the requested information and you should try again later

## Related endpoints

-   [Get monitor details](https://docs.socialdata.tools/monitoring/get-monitor-details/)
-   [Monitor event history](https://docs.socialdata.tools/monitoring/monitor-event-history/)
-   [Update monitor](https://docs.socialdata.tools/monitoring/edit-monitor-webhook/)
-   [Delete monitor](https://docs.socialdata.tools/monitoring/delete-monitor/)

## Before you integrate

-   [Authentication](https://docs.socialdata.tools/getting-started/authentication/)
-   [Rate limits](https://docs.socialdata.tools/getting-started/rate-limits/)
-   [Errors](https://docs.socialdata.tools/getting-started/errors/)
-   [Monitoring API pricing](https://docs.socialdata.tools/monitoring/pricing/)
-   [Processing webhook events](https://docs.socialdata.tools/monitoring/processing-webhooks/)