> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://api.docs.modulards.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api.docs.modulards.com/_mcp/server.

# List Malware Scanner configurations

GET https://api.modulards.com/api/public/v1/preset-malware-scans

List the organization's Malware Scanner global configurations (presets): the named scan schedules applied to websites, each on the basic or the premium tier, with how many websites use each and which one is the default for new websites. The id is what the `preset_malware_scan` field of "Create connection plugin" (`POST /api/public/v1/connection-plugins`) takes, and what the requests under "Malware Scan Configurations" address: read one in full, create, edit or delete it, and assign websites to it there.

Every row carries the same attributes as "Show malware scan configuration", under the keys the writes accept: `id`, `name`, `tier` (basic, premium), `status` (enabled, disabled), `is_default`, `schedule` (`frequency`, `start_hour`, `timezone`, `day_week`, `day_month`), `extensions`, `max_file_size` (bytes), `sites_count` (opt in with `fields[preset-malware-scans]=sites_count`), `created_at`, `updated_at`.

Reference: https://api.docs.modulards.com/modular-ds-public-api/malware-scanner/list-malware-scanner-configurations

## Authentication

- `Authorization` header (bearer token, required) — Personal access token created in the Modular DS dashboard; read-only tokens can only call GET endpoints.

## Request

### Query parameters

- `filter[id]` (string, optional) — Exact configuration ids
- `filter[s]` (string, optional) — Free-text search over the configuration name
- `filter[is_default]` (string, optional) — 1 = only the default configuration for new websites; 0 = the others
- `filter[status]` (string, optional) — Comma list: enabled, disabled
- `filter[tier]` (string, optional) — Comma list: basic, premium
- `sort` (string, optional) — name (default), -name, created_at, sites_count (prefix - for descending)
- `page[number]` (string, optional) — Page number
- `page[size]` (string, optional) — Items per page, max 50
- `fields[preset-malware-scans]` (string, optional) — Opt into the computed website count

## Response

### 200

200 - Malware scan configurations

- `data` (list of object, optional)
  - `attributes` (object, optional)
    - `created_at` (string, optional)
    - `extensions` (list of string, optional)
    - `is_default` (boolean, optional)
    - `max_file_size` (double, optional)
    - `name` (string, optional)
    - `schedule` (object, optional)
      - `day_month` (double, optional, nullable)
      - `day_week` (string, optional, nullable)
      - `frequency` (string, optional)
      - `start_hour` (string, optional)
      - `timezone` (string, optional)
    - `sites_count` (double, optional)
    - `status` (string, optional)
    - `tier` (string, optional)
    - `updated_at` (string, optional)
  - `id` (string, optional)
  - `links` (object, optional)
    - `self` (string, optional)
  - `type` (string, optional)
- `jsonapi` (object, optional)
  - `version` (string, optional)
- `links` (object, optional)
  - `first` (string, optional)
  - `last` (string, optional)
  - `next` (any, optional, nullable)
  - `prev` (any, optional, nullable)
- `meta` (object, optional)
  - `current_page` (double, optional)
  - `from` (double, optional)
  - `last_page` (double, optional)
  - `links` (list of object, optional)
    - `active` (boolean, optional)
    - `label` (string, optional)
    - `url` (string, optional, nullable)
  - `path` (string, optional)
  - `per_page` (double, optional)
  - `to` (double, optional)
  - `total` (double, optional)

## Examples

**Response**

```json
{
  "data": [
    {
      "attributes": {
        "created_at": "2026-09-18T09:00:00.000000Z",
        "extensions": [
          "php3",
          "phtml"
        ],
        "is_default": true,
        "max_file_size": 5242880,
        "name": "Client sites",
        "schedule": {
          "day_month": 1,
          "day_week": null,
          "frequency": "monthly",
          "start_hour": "03:00",
          "timezone": "Europe/Madrid"
        },
        "status": "enabled",
        "tier": "basic",
        "updated_at": "2026-09-18T09:00:00.000000Z"
      },
      "id": "7",
      "links": {
        "self": "{{base_url}}/api/public/v1/preset-malware-scans/7"
      },
      "type": "preset-malware-scans"
    },
    {
      "attributes": {
        "created_at": "2026-08-01T09:00:00.000000Z",
        "extensions": [],
        "is_default": false,
        "max_file_size": 5242880,
        "name": "Premium clients",
        "schedule": {
          "day_month": null,
          "day_week": "monday",
          "frequency": "weekly",
          "start_hour": "02:00",
          "timezone": "Europe/Madrid"
        },
        "sites_count": 12,
        "status": "enabled",
        "tier": "premium",
        "updated_at": "2026-09-10T09:00:00.000000Z"
      },
      "id": "8",
      "links": {
        "self": "{{base_url}}/api/public/v1/preset-malware-scans/8"
      },
      "type": "preset-malware-scans"
    }
  ],
  "jsonapi": {
    "version": "1.1"
  },
  "links": {
    "first": "{{base_url}}/api/public/v1/preset-malware-scans?page%5Bnumber%5D=1",
    "last": "{{base_url}}/api/public/v1/preset-malware-scans?page%5Bnumber%5D=1",
    "next": null,
    "prev": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "active": false,
        "label": "&laquo; Previous",
        "url": null
      },
      {
        "active": true,
        "label": "1",
        "url": "{{base_url}}/api/public/v1/preset-malware-scans?page%5Bnumber%5D=1"
      },
      {
        "active": false,
        "label": "Next &raquo;",
        "url": null
      }
    ],
    "path": "{{base_url}}/api/public/v1/preset-malware-scans",
    "per_page": 15,
    "to": 2,
    "total": 2
  }
}
```

**SDK Code**

```python 200 - Malware scan configurations
import requests

url = "https://api.modulards.com/api/public/v1/preset-malware-scans"

headers = {"Authorization": "Bearer <token>"}

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

print(response.json())
```

```javascript 200 - Malware scan configurations
const url = 'https://api.modulards.com/api/public/v1/preset-malware-scans';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go 200 - Malware scan configurations
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.modulards.com/api/public/v1/preset-malware-scans"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby 200 - Malware scan configurations
require 'uri'
require 'net/http'

url = URI("https://api.modulards.com/api/public/v1/preset-malware-scans")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java 200 - Malware scan configurations
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.modulards.com/api/public/v1/preset-malware-scans")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php 200 - Malware scan configurations
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.modulards.com/api/public/v1/preset-malware-scans', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp 200 - Malware scan configurations
using RestSharp;

var client = new RestClient("https://api.modulards.com/api/public/v1/preset-malware-scans");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift 200 - Malware scan configurations
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.modulards.com/api/public/v1/preset-malware-scans")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```