> 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 Broken Links Checker global configurations

GET https://api.modulards.com/api/public/v1/preset-broken-links

Lists your Broken Links Checker global configurations: the named scan schedules you assign to websites, with what each one checks (internal links, external links, mixed content) and how it reads page content. Use it to find the id of a configuration to retrieve, update, delete or assign websites to, or to see which one new websites receive by default.

The id is also what the `preset_broken_link` field of "Create a Modular Connector download link" takes, to attach a configuration to a website that is being connected.

Reference: https://api.docs.modulards.com/modular-ds-public-api/broken-links-checker/broken-links-global-configurations/list-broken-links-checker-global-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[s]` (string, optional) — Free-text search over the configuration name.
- `filter[is_default]` (string, optional) — `1` returns only the configuration new websites receive; `0` returns the others.
- `sort` (string, optional) — `name` (default), `created_at` or `sites_count`; prefix with `-` for descending.
- `page[number]` (string, optional) — Page number, starting at 1. Default 1.
- `page[size]` (string, optional) — Items per page, 1 to 50. Default 15.
- `fields[preset-broken-links]` (string, optional) — Sparse fieldset: only the attributes named here are answered. `sites_count`, the number of websites that use each configuration, is computed only when named here or when sorting by `sites_count`; a fieldset that names only `sites_count` answers only that attribute.
- `filter[id][]` (string, optional) — Exact configuration ids. Repeat the parameter for several: any of them matches.
- `filter[status][]` (string, optional) — `enabled` or `disabled`. Repeat the parameter for several: any of them matches.

## Response

### 200

200 - Broken link configurations

- `data` (list of ApiPublicV1PresetBrokenLinksGetResponsesContentApplicationJsonSchemaDataItems, optional)
- `jsonapi` (ApiPublicV1PresetBrokenLinksGetResponsesContentApplicationJsonSchemaJsonapi, optional)
- `links` (ApiPublicV1PresetBrokenLinksGetResponsesContentApplicationJsonSchemaLinks, optional)
- `meta` (ApiPublicV1PresetBrokenLinksGetResponsesContentApplicationJsonSchemaMeta, optional)

## Types

### ApiPublicV1PresetBrokenLinksGetResponsesContentApplicationJsonSchemaDataItems

- `attributes` (ApiPublicV1PresetBrokenLinksGetResponsesContentApplicationJsonSchemaDataItemsAttributes, optional)
- `id` (string, optional)
- `links` (ApiPublicV1PresetBrokenLinksGetResponsesContentApplicationJsonSchemaDataItemsLinks, optional)
- `type` (string, optional)

### ApiPublicV1PresetBrokenLinksGetResponsesContentApplicationJsonSchemaJsonapi

- `version` (string, optional)

### ApiPublicV1PresetBrokenLinksGetResponsesContentApplicationJsonSchemaLinks

- `first` (string, optional)
- `last` (string, optional)
- `next` (any, optional, nullable)
- `prev` (any, optional, nullable)

### ApiPublicV1PresetBrokenLinksGetResponsesContentApplicationJsonSchemaMeta

- `current_page` (double, optional)
- `from` (double, optional)
- `last_page` (double, optional)
- `links` (list of ApiPublicV1PresetBrokenLinksGetResponsesContentApplicationJsonSchemaMetaLinksItems, optional)
- `path` (string, optional)
- `per_page` (double, optional)
- `to` (double, optional)
- `total` (double, optional)

### ApiPublicV1PresetBrokenLinksGetResponsesContentApplicationJsonSchemaDataItemsAttributes

- `check_external` (boolean, optional)
- `check_internal` (boolean, optional)
- `check_mixed_content` (boolean, optional)
- `created_at` (string, optional)
- `is_default` (boolean, optional)
- `mode` (string, optional)
- `name` (string, optional)
- `resource_types` (list of string, optional)
- `schedule` (ApiPublicV1PresetBrokenLinksGetResponsesContentApplicationJsonSchemaDataItemsAttributesSchedule, optional)
- `sites_count` (double, optional)
- `status` (string, optional)
- `updated_at` (string, optional)

### ApiPublicV1PresetBrokenLinksGetResponsesContentApplicationJsonSchemaDataItemsLinks

- `self` (string, optional)

### ApiPublicV1PresetBrokenLinksGetResponsesContentApplicationJsonSchemaMetaLinksItems

- `active` (boolean, optional)
- `label` (string, optional)
- `url` (string, optional, nullable)

### ApiPublicV1PresetBrokenLinksGetResponsesContentApplicationJsonSchemaDataItemsAttributesSchedule

- `day_month` (double, optional, nullable)
- `day_week` (string, optional, nullable)
- `frequency` (string, optional)
- `start_hour` (string, optional)
- `timezone` (string, optional)

## Examples

**Response**

```json
{
  "data": [
    {
      "attributes": {
        "check_external": true,
        "check_internal": true,
        "check_mixed_content": true,
        "created_at": "2026-09-01T09:00:00.000000Z",
        "is_default": true,
        "mode": "plain",
        "name": "Weekly check",
        "resource_types": [
          "link",
          "image"
        ],
        "schedule": {
          "day_month": null,
          "day_week": "sunday",
          "frequency": "weekly",
          "start_hour": "04:00",
          "timezone": "Europe/Madrid"
        },
        "status": "enabled",
        "updated_at": "2026-09-01T09:00:00.000000Z"
      },
      "id": "3",
      "links": {
        "self": "{{base_url}}/api/public/v1/preset-broken-links/3"
      },
      "type": "preset-broken-links"
    },
    {
      "attributes": {
        "check_external": false,
        "check_internal": true,
        "check_mixed_content": false,
        "created_at": "2026-08-01T09:00:00.000000Z",
        "is_default": false,
        "mode": "render",
        "name": "Rendered pages",
        "resource_types": [
          "link",
          "image",
          "script",
          "stylesheet"
        ],
        "schedule": {
          "day_month": 1,
          "day_week": null,
          "frequency": "monthly",
          "start_hour": "05:00",
          "timezone": "Europe/Madrid"
        },
        "sites_count": 5,
        "status": "enabled",
        "updated_at": "2026-09-10T09:00:00.000000Z"
      },
      "id": "4",
      "links": {
        "self": "{{base_url}}/api/public/v1/preset-broken-links/4"
      },
      "type": "preset-broken-links"
    }
  ],
  "jsonapi": {
    "version": "1.1"
  },
  "links": {
    "first": "{{base_url}}/api/public/v1/preset-broken-links?page%5Bnumber%5D=1",
    "last": "{{base_url}}/api/public/v1/preset-broken-links?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-broken-links?page%5Bnumber%5D=1"
      },
      {
        "active": false,
        "label": "Next &raquo;",
        "url": null
      }
    ],
    "path": "{{base_url}}/api/public/v1/preset-broken-links",
    "per_page": 15,
    "to": 2,
    "total": 2
  }
}
```

**SDK Code**

```python 200 - Broken link configurations
import requests

url = "https://api.modulards.com/api/public/v1/preset-broken-links"

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

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

print(response.json())
```

```javascript 200 - Broken link configurations
const url = 'https://api.modulards.com/api/public/v1/preset-broken-links';
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 - Broken link configurations
package main

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

func main() {

	url := "https://api.modulards.com/api/public/v1/preset-broken-links"

	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 - Broken link configurations
require 'uri'
require 'net/http'

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

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 - Broken link 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-broken-links")
  .header("Authorization", "Bearer <token>")
  .asString();
```

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

$client = new \GuzzleHttp\Client();

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

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

```csharp 200 - Broken link configurations
using RestSharp;

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

```swift 200 - Broken link configurations
import Foundation

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

let request = NSMutableURLRequest(url: NSURL(string: "https://api.modulards.com/api/public/v1/preset-broken-links")! 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()
```