> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://api.docs.modulards.com/modular-ds-public-api/uptime-monitor/uptime-global-configurations/retrieve-an-uptime-global-configuration/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api.docs.modulards.com/_mcp/server.

# Retrieve an uptime global configuration

GET https://api.modulards.com/api/public/v1/preset-uptimes/{preset_uptime}

Returns one Uptime Monitor global configuration: its check settings (interval, timeout, HTTP method and accepted status codes), the region its checks run from and whether new websites receive it by default. Ids come from "List uptime global configurations".

Unlike the list, the answer always carries `sites_count`, the number of websites that use the configuration.

Reference: https://api.docs.modulards.com/modular-ds-public-api/uptime-monitor/uptime-global-configurations/retrieve-an-uptime-global-configuration

## Authentication

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

## Request

### Path parameters

- `preset_uptime` (string, required)

## Response

### 200

200 - Uptime configuration

- `data` (ApiPublicV1PresetUptimesPresetUptimeGetResponsesContentApplicationJsonSchemaData, optional)
- `jsonapi` (ApiPublicV1PresetUptimesPresetUptimeGetResponsesContentApplicationJsonSchemaJsonapi, optional)

## Types

### ApiPublicV1PresetUptimesPresetUptimeGetResponsesContentApplicationJsonSchemaData

- `attributes` (ApiPublicV1PresetUptimesPresetUptimeGetResponsesContentApplicationJsonSchemaDataAttributes, optional)
- `id` (string, optional)
- `links` (ApiPublicV1PresetUptimesPresetUptimeGetResponsesContentApplicationJsonSchemaDataLinks, optional)
- `type` (string, optional)

### ApiPublicV1PresetUptimesPresetUptimeGetResponsesContentApplicationJsonSchemaJsonapi

- `version` (string, optional)

### ApiPublicV1PresetUptimesPresetUptimeGetResponsesContentApplicationJsonSchemaDataAttributes

- `created_at` (string, optional)
- `interval` (double, optional)
- `is_default` (boolean, optional)
- `method` (string, optional)
- `name` (string, optional)
- `region` (string, optional)
- `sites_count` (double, optional)
- `status` (string, optional)
- `status_codes` (list of string, optional)
- `timeout` (double, optional)
- `updated_at` (string, optional)

### ApiPublicV1PresetUptimesPresetUptimeGetResponsesContentApplicationJsonSchemaDataLinks

- `self` (string, optional)

## Examples

**Response**

```json
{
  "data": {
    "attributes": {
      "created_at": "2026-09-17T09:12:44.000000Z",
      "interval": 300,
      "is_default": false,
      "method": "HEAD",
      "name": "Shops",
      "region": "eu-west-1",
      "sites_count": 3,
      "status": "enabled",
      "status_codes": [
        "2xx"
      ],
      "timeout": 30000,
      "updated_at": "2026-09-17T09:12:44.000000Z"
    },
    "id": "9",
    "links": {
      "self": "https://api.modulards.com/api/public/v1/preset-uptimes/9"
    },
    "type": "preset-uptimes"
  },
  "jsonapi": {
    "version": "1.1"
  }
}
```

**SDK Code**

```python 200 - Uptime configuration
import requests

url = "https://api.modulards.com/api/public/v1/preset-uptimes/preset_uptime"

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

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

print(response.json())
```

```javascript 200 - Uptime configuration
const url = 'https://api.modulards.com/api/public/v1/preset-uptimes/preset_uptime';
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 - Uptime configuration
package main

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

func main() {

	url := "https://api.modulards.com/api/public/v1/preset-uptimes/preset_uptime"

	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 - Uptime configuration
require 'uri'
require 'net/http'

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

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 - Uptime configuration
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-uptimes/preset_uptime")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php 200 - Uptime configuration
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

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

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

```csharp 200 - Uptime configuration
using RestSharp;

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

```swift 200 - Uptime configuration
import Foundation

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

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