> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/tr/docs/products/watchlist

# Domain İzleme Listesi API ürünü

Alan izleme listesini yönetin. Alanlar kullanılabilir hale geldiğinde veya durum değiştiğinde bildirim alın. Doğru uç noktayı seçmek ve tam olarak ne döndürdüğünü görmek için bu referansı kullanın.

[Ürün sayfasını görüntüle](https://domscan.net/tr/watchlist-api)

## İşlemler

GET `/v1/watchlist` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#getWatchlist)

POST `/v1/watchlist` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#addToWatchlist)

PATCH `/v1/watchlist/:domain` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#updateWatchlistDomain)

DELETE `/v1/watchlist` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#removeFromWatchlist)

GET `/v1/watchlist/expiring` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#getExpiringWatchlist)

GET `/v1/watchlist/available` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#getAvailableWatchlist)

GET `/v1/webhooks` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#listAlertWebhooks)[Rehberi okuyun](https://domscan.net/tr/webhook-alerts-api)

POST `/v1/webhooks` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#createAlertWebhook)[Rehberi okuyun](https://domscan.net/tr/webhook-alerts-api)

PATCH `/v1/webhooks/:webhook_id` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#updateAlertWebhook)[Rehberi okuyun](https://domscan.net/tr/webhook-alerts-api)

DELETE `/v1/webhooks/:webhook_id` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#deleteAlertWebhook)[Rehberi okuyun](https://domscan.net/tr/webhook-alerts-api)

POST `/v1/webhooks/:webhook_id/test` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#testAlertWebhook)[Rehberi okuyun](https://domscan.net/tr/webhook-alerts-api)

POST `/v1/webhooks/:webhook_id/rotate-secret` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#rotateAlertWebhookSecret)[Rehberi okuyun](https://domscan.net/tr/webhook-alerts-api)

GET `/v1/webhooks/:webhook_id/deliveries` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#listAlertWebhookDeliveries)[Rehberi okuyun](https://domscan.net/tr/webhook-alerts-api)

GET `/v1/watchlist/alerts` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#listWatchlistAlerts)[Rehberi okuyun](https://domscan.net/tr/webhook-alerts-api)

POST `/v1/watchlist/alerts` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#createWatchlistAlert)[Rehberi okuyun](https://domscan.net/tr/webhook-alerts-api)

GET `/v1/watchlist/alerts/:subscription_id` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#getWatchlistAlert)[Rehberi okuyun](https://domscan.net/tr/webhook-alerts-api)

PATCH `/v1/watchlist/alerts/:subscription_id` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#updateWatchlistAlert)[Rehberi okuyun](https://domscan.net/tr/webhook-alerts-api)

DELETE `/v1/watchlist/alerts/:subscription_id` [API referansını görüntüle](https://domscan.net/tr/docs/products/watchlist#deleteWatchlistAlert)[Rehberi okuyun](https://domscan.net/tr/webhook-alerts-api)

## GET `/v1/watchlist`

İşlem: `getWatchlist`
Krediler ve kimlik doğrulama: 1
Kimlik doğrulama gerekli

GET /v1/watchlist Kredi: 1

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| limit | integer | isteğe bağlı |
| cursor | string | isteğe bağlı |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `has_more` | boolean |
| `next_cursor` | string \| null |
| `watchlist[]` | object[] |
| `watchlist[]` | object |
| `watchlist[].domain` | string |
| `watchlist[].added_at` | string |
| `watchlist[].status` | string |
| `watchlist[].last_checked` | string |
| `watchlist[].expiry_date` | string |
| `watchlist[].days_until_expiry` | integer |
| `watchlist[].notify_email` | string |
| `watchlist[].check_count` | integer |
| `total` | integer |
| `max_domains` | integer |
| `limit_basis` | string |
| `updated_at` | string |

#### Örnek istek

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/watchlist"
```

```javascript
const response = await fetch("https://domscan.net/v1/watchlist", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/watchlist",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/watchlist", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/watchlist")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

#### Örnek yanıt

```json
{
  "watchlist": [
    {
      "domain": "example.com",
      "added_at": "2024-01-01T00:00:00Z",
      "status": "registered",
      "last_checked": "2024-01-15T12:00:00Z"
    }
  ],
  "total": 1,
  "max_domains": 333,
  "limit_basis": "monthly_credits",
  "updated_at": "2024-01-15T12:00:00Z"
}
```

#### HTTP durum kodları

- `200` OK
- `400` Hatalı İstek
- `401` Yetkisiz
- `402` Ödeme Gerekli
- `429` Çok Fazla İstek

## POST `/v1/watchlist`

İşlem: `addToWatchlist`
Krediler ve kimlik doğrulama: 1
Kimlik doğrulama gerekli

POST /v1/watchlist Kredi: 1

#### Gövde parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| domain | string | gerekli |
| notify_email | string | isteğe bağlı |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `success` | boolean |
| `message` | string |
| `watchlist[]` | object[] |
| `watchlist[]` | object |
| `watchlist[].domain` | string |
| `watchlist[].added_at` | string |
| `watchlist[].status` | string |
| `watchlist[].last_checked` | string |
| `watchlist[].expiry_date` | string |
| `watchlist[].days_until_expiry` | integer |
| `watchlist[].notify_email` | string |
| `watchlist[].check_count` | integer |
| `total` | integer |
| `max_domains` | integer |
| `limit_basis` | string |

#### Örnek istek

```bash
curl -X POST "https://domscan.net/v1/watchlist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "domain": "example.org",
  "notify_email": "alerts@example.com"
}'
```

```javascript
const response = await fetch("https://domscan.net/v1/watchlist", {
  method: "POST",
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "domain": "example.org",
    "notify_email": "alerts@example.com"
  }),
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.post(
    "https://domscan.net/v1/watchlist",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
    json={
        "domain": "example.org",
        "notify_email": "alerts@example.com",
    },
)
print(response.json())
```

```go
package main

func main() {
	body := strings.NewReader(`{
	  "domain": "example.org",
	  "notify_email": "alerts@example.com"
	}`)
	req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/watchlist", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/watchlist")
request = Net::HTTP::Post.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
  "domain" => "example.org",
  "notify_email" => "alerts@example.com"
})

#### Örnek yanıt

```json
{
  "success": true,
  "message": "Added example.org to watchlist",
  "watchlist": [
    {
      "domain": "example.com",
      "added_at": "2026-06-02T09:12:00.000Z",
      "last_checked": "2026-10-09T03:00:12.000Z",
      "status": "expiring_soon",
      "expiry_date": "2026-12-18T14:22:08Z",
      "days_until_expiry": 70,
      "notify_email": "alerts@example.com"
    },
    {
      "domain": "example.org",
      "added_at": "2026-10-09T10:15:30.000Z",
      "status": "unknown",
      "notify_email": "alerts@example.com"
    }
  ],
  "total": 2,
  "max_domains": 333,
  "limit_basis": "monthly_credits"
}
```

#### HTTP durum kodları

- `201` Oluşturuldu
- `400` Hatalı İstek
- `401` Yetkisiz
- `402` Ödeme Gerekli
- `409` HTTP 409
- `422` HTTP 422
- `429` Çok Fazla İstek

## PATCH `/v1/watchlist/:domain`

İşlem: `updateWatchlistDomain`
Krediler ve kimlik doğrulama: Ücretsiz
Kimlik doğrulama gerekli

PATCH /v1/watchlist/:domain Kredi: 0

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| domain | string | gerekli |

#### Gövde parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| notify_email | string \| null | gerekli |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `success` | boolean |
| `message` | string |
| `domain` | object |
| `domain.domain` | string |
| `domain.added_at` | string |
| `domain.status` | string |
| `domain.last_checked` | string |
| `domain.expiry_date` | string |
| `domain.days_until_expiry` | integer |
| `domain.notify_email` | string |
| `domain.check_count` | integer |

#### Örnek istek

```bash
curl -X PATCH "https://domscan.net/v1/watchlist/example.com" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "notify_email": "ops@example.com"
}'
```

```javascript
const response = await fetch("https://domscan.net/v1/watchlist/example.com", {
  method: "PATCH",
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "notify_email": "ops@example.com"
  }),
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.patch(
    "https://domscan.net/v1/watchlist/example.com",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
    json={
        "notify_email": "ops@example.com",
    },
)
print(response.json())
```

```go
package main

func main() {
	body := strings.NewReader(`{
	  "notify_email": "ops@example.com"
	}`)
	req, err := http.NewRequest(http.MethodPatch, "https://domscan.net/v1/watchlist/example.com", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/watchlist/example.com")
request = Net::HTTP::Patch.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
  "notify_email" => "ops@example.com"
})

#### Örnek yanıt

```json
{
  "success": true,
  "message": "Updated example.com in your watchlist",
  "domain": {
    "domain": "example.com",
    "added_at": "2026-06-02T09:12:00.000Z",
    "status": "registered",
    "notify_email": "ops@example.com",
    "check_count": 12
  }
}
```

#### HTTP durum kodları

- `200` OK
- `400` Hatalı İstek
- `401` Yetkisiz
- `404` Bulunamadı
- `429` Çok Fazla İstek

## DELETE `/v1/watchlist`

İşlem: `removeFromWatchlist`
Krediler ve kimlik doğrulama: Ücretsiz
Kimlik doğrulama gerekli

DELETE /v1/watchlist Kredi: 0

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| domain | string | gerekli |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `success` | boolean |
| `message` | string |
| `domain` | string |
| `watchlist[]` | object[] |
| `watchlist[]` | object |
| `watchlist[].domain` | string |
| `watchlist[].added_at` | string |
| `watchlist[].status` | string |
| `watchlist[].last_checked` | string |
| `watchlist[].expiry_date` | string |
| `watchlist[].days_until_expiry` | integer |
| `watchlist[].notify_email` | string |
| `watchlist[].check_count` | integer |
| `total` | integer |

#### Örnek istek

```bash
curl -X DELETE "https://domscan.net/v1/watchlist?domain=example.com" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{}'
```

```javascript
const response = await fetch("https://domscan.net/v1/watchlist?domain=example.com", {
  method: "DELETE",
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({}),
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.delete(
    "https://domscan.net/v1/watchlist?domain=example.com",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
    json={},
)
print(response.json())
```

```go
package main

func main() {
	body := strings.NewReader(`{}`)
	req, err := http.NewRequest(http.MethodDelete, "https://domscan.net/v1/watchlist?domain=example.com", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/watchlist?domain=example.com")
request = Net::HTTP::Delete.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({})

#### Örnek yanıt

```json
{
  "success": true,
  "message": "Request completed",
  "domain": "example.com",
  "watchlist": [
    {
      "domain": "example.com",
      "added_at": "2026-08-27T12:00:00Z",
      "status": "registered",
      "last_checked": "2026-08-27T12:00:00Z",
      "expiry_date": "2026-08-27T12:00:00Z",
      "days_until_expiry": 1,
      "notify_email": "user@example.com",
      "check_count": 1
    }
  ],
  "total": 1
}
```

#### HTTP durum kodları

- `200` OK
- `400` Hatalı İstek
- `401` Yetkisiz
- `402` Ödeme Gerekli
- `429` Çok Fazla İstek

## GET `/v1/watchlist/expiring`

İşlem: `getExpiringWatchlist`
Krediler ve kimlik doğrulama: 1
Kimlik doğrulama gerekli

GET /v1/watchlist/expiring Kredi: 1

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| days | integer Varsayılan `90` | isteğe bağlı |
| limit | integer | isteğe bağlı |
| cursor | string | isteğe bağlı |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `has_more` | boolean |
| `next_cursor` | string \| null |
| `expiring_domains[]` | object[] |
| `expiring_domains[]` | object |
| `expiring_domains[].domain` | string |
| `expiring_domains[].added_at` | string |
| `expiring_domains[].status` | string |
| `expiring_domains[].last_checked` | string |
| `expiring_domains[].expiry_date` | string |
| `expiring_domains[].days_until_expiry` | integer |
| `expiring_domains[].notify_email` | string |
| `expiring_domains[].check_count` | integer |
| `total` | integer |
| `threshold_days` | integer |

#### Örnek istek

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/watchlist/expiring?days=90"
```

```javascript
const response = await fetch("https://domscan.net/v1/watchlist/expiring?days=90", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/watchlist/expiring?days=90",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/watchlist/expiring?days=90", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/watchlist/expiring?days=90")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

#### Örnek yanıt

```json
{
  "expiring_domains": [
    {
      "domain": "example.com",
      "added_at": "2026-06-02T09:12:00.000Z",
      "last_checked": "2026-10-09T03:00:12.000Z",
      "status": "expiring_soon",
      "expiry_date": "2026-12-18T14:22:08Z",
      "days_until_expiry": 70,
      "notify_email": "alerts@example.com"
    }
  ],
  "total": 1,
  "threshold_days": 90
}
```

#### HTTP durum kodları

- `200` OK
- `400` Hatalı İstek
- `401` Yetkisiz
- `402` Ödeme Gerekli
- `429` Çok Fazla İstek

## GET `/v1/watchlist/available`

İşlem: `getAvailableWatchlist`
Krediler ve kimlik doğrulama: 1
Kimlik doğrulama gerekli

GET /v1/watchlist/available Kredi: 1

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| limit | integer | isteğe bağlı |
| cursor | string | isteğe bağlı |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `has_more` | boolean |
| `next_cursor` | string \| null |
| `available_domains[]` | object[] |
| `available_domains[]` | object |
| `available_domains[].domain` | string |
| `available_domains[].added_at` | string |
| `available_domains[].status` | string |
| `available_domains[].last_checked` | string |
| `available_domains[].expiry_date` | string |
| `available_domains[].days_until_expiry` | integer |
| `available_domains[].notify_email` | string |
| `available_domains[].check_count` | integer |
| `total` | integer |
| `message` | string |

#### Örnek istek

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/watchlist/available"
```

```javascript
const response = await fetch("https://domscan.net/v1/watchlist/available", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/watchlist/available",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/watchlist/available", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/watchlist/available")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

#### Örnek yanıt

```json
{
  "has_more": false,
  "next_cursor": "example",
  "available_domains": [
    {
      "domain": "example.com",
      "added_at": "2026-08-27T12:00:00Z",
      "status": "registered",
      "last_checked": "2026-08-27T12:00:00Z",
      "expiry_date": "2026-08-27T12:00:00Z",
      "days_until_expiry": 1,
      "notify_email": "user@example.com",
      "check_count": 1
    }
  ],
  "total": 1,
  "message": "Request completed"
}
```

#### HTTP durum kodları

- `200` OK
- `400` Hatalı İstek
- `401` Yetkisiz
- `402` Ödeme Gerekli
- `429` Çok Fazla İstek

## GET `/v1/webhooks`

İşlem: `listAlertWebhooks`
Krediler ve kimlik doğrulama: Ücretsiz
Kimlik doğrulama gerekli

GET /v1/webhooks Kredi: 0

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `endpoints[]` | object[] |
| `endpoints[]` | object |
| `endpoints[].id` | string |
| `endpoints[].url` | string |
| `endpoints[].description` | string \| null |
| `endpoints[].events[]` | string[] |
| `endpoints[].status` | string |
| `endpoints[].disabled_reason` | string \| null |
| `endpoints[].consecutive_failures` | integer |
| `endpoints[].secret_hint` | string |
| `endpoints[].previous_secret_expires_at` | string \| null |
| `endpoints[].secret_rotated_at` | string \| null |
| `endpoints[].last_success_at` | string \| null |
| `endpoints[].last_failure_at` | string \| null |
| `endpoints[].last_error` | string \| null |
| `endpoints[].created_at` | string |
| `endpoints[].updated_at` | string |
| `endpoints[].disabled_at` | string \| null |
| `available_events[]` | string[] |
| `all_events` | string |
| `test_event` | string |
| `policy` | object |
| `policy.secret_rotation_grace_seconds` | integer |
| `policy.secret_rotation_credits` | integer |
| `policy.credits_per_delivered_alert` | integer |
| `policy.test_event_credits` | integer |
| `policy.job_event_credits` | integer |
| `policy.failed_deliveries_charged` | boolean |
| `policy.max_endpoints` | integer |
| `policy.max_attempts` | integer |
| `policy.disable_after_consecutive_failures` | integer |
| `policy.signature_tolerance_seconds` | integer |

#### Örnek istek

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/webhooks"
```

```javascript
const response = await fetch("https://domscan.net/v1/webhooks", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/webhooks",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/webhooks", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/webhooks")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

#### Örnek yanıt

```json
{
  "endpoints": [
    {
      "id": "example-id",
      "url": "https://example.com",
      "events": [
        "example"
      ],
      "status": "active",
      "secret_hint": "example",
      "created_at": "2026-08-27T12:00:00Z",
      "description": "example",
      "disabled_reason": "customer",
      "consecutive_failures": 1,
      "previous_secret_expires_at": "2026-08-27T12:00:00Z",
      "secret_rotated_at": "2026-08-27T12:00:00Z",
      "last_success_at": "2026-08-27T12:00:00Z",
      "last_failure_at": "2026-08-27T12:00:00Z",
      "last_error": "example",
      "updated_at": "2026-08-27T12:00:00Z",
      "disabled_at": "2026-08-27T12:00:00Z"
    }
  ],
  "available_events": [
    "domain.available"
  ],
  "policy": {
    "credits_per_delivered_alert": 2,
    "test_event_credits": 0,
    "failed_deliveries_charged": false,
    "max_endpoints": 1,
    "max_attempts": 1,
    "disable_after_consecutive_failures": 1,
    "signature_tolerance_seconds": 1,
    "secret_rotation_grace_seconds": 86400,
    "secret_rotation_credits": 0,
    "job_event_credits": 0
  },
  "all_events": "*",
  "test_event": "webhook.test"
}
```

#### HTTP durum kodları

- `200` OK
- `401` Yetkisiz
- `429` Çok Fazla İstek

## POST `/v1/webhooks`

İşlem: `createAlertWebhook`
Krediler ve kimlik doğrulama: Ücretsiz
Kimlik doğrulama gerekli

POST /v1/webhooks Kredi: 0

#### Gövde parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| url | string | gerekli |
| description | string \| null | isteğe bağlı |
| events | unknown[] | isteğe bağlı |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `endpoint` | object |
| `endpoint.id` | string |
| `endpoint.url` | string |
| `endpoint.description` | string \| null |
| `endpoint.events[]` | string[] |
| `endpoint.status` | string |
| `endpoint.disabled_reason` | string \| null |
| `endpoint.consecutive_failures` | integer |
| `endpoint.secret_hint` | string |
| `endpoint.previous_secret_expires_at` | string \| null |
| `endpoint.secret_rotated_at` | string \| null |
| `endpoint.last_success_at` | string \| null |
| `endpoint.last_failure_at` | string \| null |
| `endpoint.last_error` | string \| null |
| `endpoint.created_at` | string |
| `endpoint.updated_at` | string |
| `endpoint.disabled_at` | string \| null |
| `secret` | string |

#### Örnek istek

```bash
curl -X POST "https://domscan.net/v1/webhooks" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "url": "https://hooks.example.com/domscan",
  "description": "Production alerts",
  "events": [
    "domain.expiring_30",
    "domain.available",
    "domain.dns_changed"
  ]
}'
```

```javascript
const response = await fetch("https://domscan.net/v1/webhooks", {
  method: "POST",
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "url": "https://hooks.example.com/domscan",
    "description": "Production alerts",
    "events": [
      "domain.expiring_30",
      "domain.available",
      "domain.dns_changed"
    ]
  }),
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.post(
    "https://domscan.net/v1/webhooks",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
    json={
        "url": "https://hooks.example.com/domscan",
        "description": "Production alerts",
        "events": [
            "domain.expiring_30",
            "domain.available",
            "domain.dns_changed",
        ],
    },
)
print(response.json())
```

```go
package main

func main() {
	body := strings.NewReader(`{
	  "url": "https://hooks.example.com/domscan",
	  "description": "Production alerts",
	  "events": [
	    "domain.expiring_30",
	    "domain.available",
	    "domain.dns_changed"
	  ]
	}`)
	req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/webhooks", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/webhooks")
request = Net::HTTP::Post.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
  "url" => "https://hooks.example.com/domscan",
  "description" => "Production alerts",
  "events" => [
    "domain.expiring_30",
    "domain.available",
    "domain.dns_changed"
  ]
})

#### Örnek yanıt

```json
{
  "endpoint": {
    "id": "example-id",
    "url": "https://example.com",
    "events": [
      "example"
    ],
    "status": "active",
    "secret_hint": "example",
    "created_at": "2026-08-27T12:00:00Z",
    "description": "example",
    "disabled_reason": "customer",
    "consecutive_failures": 1,
    "previous_secret_expires_at": "2026-08-27T12:00:00Z",
    "secret_rotated_at": "2026-08-27T12:00:00Z",
    "last_success_at": "2026-08-27T12:00:00Z",
    "last_failure_at": "2026-08-27T12:00:00Z",
    "last_error": "example",
    "updated_at": "2026-08-27T12:00:00Z",
    "disabled_at": "2026-08-27T12:00:00Z"
  },
  "secret": "example"
}
```

#### HTTP durum kodları

- `201` Oluşturuldu
- `400` Hatalı İstek
- `401` Yetkisiz
- `409` HTTP 409
- `429` Çok Fazla İstek

## PATCH `/v1/webhooks/:webhook_id`

İşlem: `updateAlertWebhook`
Krediler ve kimlik doğrulama: Ücretsiz
Kimlik doğrulama gerekli

PATCH /v1/webhooks/:webhook_id Kredi: 0

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| webhook_id | string | gerekli |

#### Gövde parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| enabled | boolean | isteğe bağlı |
| description | string \| null | isteğe bağlı |
| events | unknown[] | isteğe bağlı |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `endpoint` | object |
| `endpoint.id` | string |
| `endpoint.url` | string |
| `endpoint.description` | string \| null |
| `endpoint.events[]` | string[] |
| `endpoint.status` | string |
| `endpoint.disabled_reason` | string \| null |
| `endpoint.consecutive_failures` | integer |
| `endpoint.secret_hint` | string |
| `endpoint.previous_secret_expires_at` | string \| null |
| `endpoint.secret_rotated_at` | string \| null |
| `endpoint.last_success_at` | string \| null |
| `endpoint.last_failure_at` | string \| null |
| `endpoint.last_error` | string \| null |
| `endpoint.created_at` | string |
| `endpoint.updated_at` | string |
| `endpoint.disabled_at` | string \| null |

#### Örnek istek

```bash
curl -X PATCH "https://domscan.net/v1/webhooks/string" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "enabled": true,
  "events": [
    "*"
  ]
}'
```

```javascript
const response = await fetch("https://domscan.net/v1/webhooks/string", {
  method: "PATCH",
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "enabled": true,
    "events": [
      "*"
    ]
  }),
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.patch(
    "https://domscan.net/v1/webhooks/string",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
    json={
        "enabled": True,
        "events": [
            "*",
        ],
    },
)
print(response.json())
```

```go
package main

func main() {
	body := strings.NewReader(`{
	  "enabled": true,
	  "events": [
	    "*"
	  ]
	}`)
	req, err := http.NewRequest(http.MethodPatch, "https://domscan.net/v1/webhooks/string", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/webhooks/string")
request = Net::HTTP::Patch.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
  "enabled" => true,
  "events" => [
    "*"
  ]
})

#### Örnek yanıt

```json
{
  "endpoint": {
    "id": "example-id",
    "url": "https://example.com",
    "events": [
      "example"
    ],
    "status": "active",
    "secret_hint": "example",
    "created_at": "2026-08-27T12:00:00Z",
    "description": "example",
    "disabled_reason": "customer",
    "consecutive_failures": 1,
    "previous_secret_expires_at": "2026-08-27T12:00:00Z",
    "secret_rotated_at": "2026-08-27T12:00:00Z",
    "last_success_at": "2026-08-27T12:00:00Z",
    "last_failure_at": "2026-08-27T12:00:00Z",
    "last_error": "example",
    "updated_at": "2026-08-27T12:00:00Z",
    "disabled_at": "2026-08-27T12:00:00Z"
  }
}
```

#### HTTP durum kodları

- `200` OK
- `400` Hatalı İstek
- `401` Yetkisiz
- `404` Bulunamadı
- `429` Çok Fazla İstek

## DELETE `/v1/webhooks/:webhook_id`

İşlem: `deleteAlertWebhook`
Krediler ve kimlik doğrulama: Ücretsiz
Kimlik doğrulama gerekli

DELETE /v1/webhooks/:webhook_id Kredi: 0

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| webhook_id | string | gerekli |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `id` | string |
| `deleted` | boolean |

#### Örnek istek

```bash
curl -X DELETE "https://domscan.net/v1/webhooks/string" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{}'
```

```javascript
const response = await fetch("https://domscan.net/v1/webhooks/string", {
  method: "DELETE",
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({}),
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.delete(
    "https://domscan.net/v1/webhooks/string",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
    json={},
)
print(response.json())
```

```go
package main

func main() {
	body := strings.NewReader(`{}`)
	req, err := http.NewRequest(http.MethodDelete, "https://domscan.net/v1/webhooks/string", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/webhooks/string")
request = Net::HTTP::Delete.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({})

#### Örnek yanıt

```json
{
  "id": "example-id",
  "deleted": true
}
```

#### HTTP durum kodları

- `200` OK
- `401` Yetkisiz
- `404` Bulunamadı
- `429` Çok Fazla İstek

## POST `/v1/webhooks/:webhook_id/test`

İşlem: `testAlertWebhook`
Krediler ve kimlik doğrulama: Ücretsiz
Kimlik doğrulama gerekli

POST /v1/webhooks/:webhook_id/test Kredi: 0

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| webhook_id | string | gerekli |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `delivery` | object |
| `delivery.id` | string |
| `delivery.endpoint_id` | string |
| `delivery.event_id` | string |
| `delivery.event_type` | string |
| `delivery.status` | string |
| `delivery.attempts` | integer |
| `delivery.next_attempt_at` | string \| null |
| `delivery.last_attempt_at` | string \| null |
| `delivery.response_status` | integer \| null |
| `delivery.last_error` | string \| null |
| `delivery.credits_charged` | integer |
| `delivery.refunded` | boolean |
| `delivery.created_at` | string |
| `delivery.delivered_at` | string \| null |
| `delivered` | boolean |

#### Örnek istek

```bash
curl -X POST "https://domscan.net/v1/webhooks/string/test" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{}'
```

```javascript
const response = await fetch("https://domscan.net/v1/webhooks/string/test", {
  method: "POST",
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({}),
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.post(
    "https://domscan.net/v1/webhooks/string/test",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
    json={},
)
print(response.json())
```

```go
package main

func main() {
	body := strings.NewReader(`{}`)
	req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/webhooks/string/test", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/webhooks/string/test")
request = Net::HTTP::Post.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({})

#### Örnek yanıt

```json
{
  "delivery": {
    "id": "example-id",
    "endpoint_id": "example",
    "event_id": "example",
    "event_type": "domain",
    "status": "pending",
    "attempts": 1,
    "next_attempt_at": "2026-08-27T12:00:00Z",
    "last_attempt_at": "2026-08-27T12:00:00Z",
    "response_status": 1,
    "last_error": "example",
    "credits_charged": 1,
    "refunded": false,
    "created_at": "2026-08-27T12:00:00Z",
    "delivered_at": "2026-08-27T12:00:00Z"
  },
  "delivered": false
}
```

#### HTTP durum kodları

- `200` OK
- `401` Yetkisiz
- `404` Bulunamadı
- `409` HTTP 409
- `429` Çok Fazla İstek

## POST `/v1/webhooks/:webhook_id/rotate-secret`

İşlem: `rotateAlertWebhookSecret`
Krediler ve kimlik doğrulama: Ücretsiz
Kimlik doğrulama gerekli

POST /v1/webhooks/:webhook_id/rotate-secret Kredi: 0

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| webhook_id | string | gerekli |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `endpoint` | object |
| `endpoint.id` | string |
| `endpoint.url` | string |
| `endpoint.description` | string \| null |
| `endpoint.events[]` | string[] |
| `endpoint.status` | string |
| `endpoint.disabled_reason` | string \| null |
| `endpoint.consecutive_failures` | integer |
| `endpoint.secret_hint` | string |
| `endpoint.previous_secret_expires_at` | string \| null |
| `endpoint.secret_rotated_at` | string \| null |
| `endpoint.last_success_at` | string \| null |
| `endpoint.last_failure_at` | string \| null |
| `endpoint.last_error` | string \| null |
| `endpoint.created_at` | string |
| `endpoint.updated_at` | string |
| `endpoint.disabled_at` | string \| null |
| `secret` | string |
| `previous_secret_expires_at` | string |
| `grace_period_seconds` | integer |

#### Örnek istek

```bash
curl -X POST "https://domscan.net/v1/webhooks/string/rotate-secret" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{}'
```

```javascript
const response = await fetch("https://domscan.net/v1/webhooks/string/rotate-secret", {
  method: "POST",
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({}),
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.post(
    "https://domscan.net/v1/webhooks/string/rotate-secret",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
    json={},
)
print(response.json())
```

```go
package main

func main() {
	body := strings.NewReader(`{}`)
	req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/webhooks/string/rotate-secret", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/webhooks/string/rotate-secret")
request = Net::HTTP::Post.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({})

#### Örnek yanıt

```json
{
  "endpoint": {
    "id": "whe_3f1c0a9b8e7d6c5b4a39281706f5e4d3",
    "url": "https://hooks.example.com/domscan",
    "events": [
      "*"
    ],
    "status": "active",
    "secret_hint": "4b7a",
    "previous_secret_expires_at": "2026-10-11T12:00:00.000Z",
    "secret_rotated_at": "2026-10-10T12:00:00.000Z",
    "created_at": "2026-10-01T09:30:00.000Z"
  },
  "secret": "whsec_...",
  "previous_secret_expires_at": "2026-10-11T12:00:00.000Z",
  "grace_period_seconds": 86400
}
```

#### HTTP durum kodları

- `200` OK
- `401` Yetkisiz
- `404` Bulunamadı
- `429` Çok Fazla İstek

## GET `/v1/webhooks/:webhook_id/deliveries`

İşlem: `listAlertWebhookDeliveries`
Krediler ve kimlik doğrulama: Ücretsiz
Kimlik doğrulama gerekli

GET /v1/webhooks/:webhook_id/deliveries Kredi: 0

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| webhook_id | string | gerekli |
| limit | integer Varsayılan `50` | isteğe bağlı |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `endpoint_id` | string |
| `deliveries[]` | object[] |
| `deliveries[]` | object |
| `deliveries[].id` | string |
| `deliveries[].endpoint_id` | string |
| `deliveries[].event_id` | string |
| `deliveries[].event_type` | string |
| `deliveries[].status` | string |
| `deliveries[].attempts` | integer |
| `deliveries[].next_attempt_at` | string \| null |
| `deliveries[].last_attempt_at` | string \| null |
| `deliveries[].response_status` | integer \| null |
| `deliveries[].last_error` | string \| null |
| `deliveries[].credits_charged` | integer |
| `deliveries[].refunded` | boolean |
| `deliveries[].created_at` | string |
| `deliveries[].delivered_at` | string \| null |

#### Örnek istek

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/webhooks/string/deliveries?limit=25"
```

```javascript
const response = await fetch("https://domscan.net/v1/webhooks/string/deliveries?limit=25", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/webhooks/string/deliveries?limit=25",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/webhooks/string/deliveries?limit=25", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/webhooks/string/deliveries?limit=25")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

#### Örnek yanıt

```json
{
  "endpoint_id": "example",
  "deliveries": [
    {
      "id": "example-id",
      "endpoint_id": "example",
      "event_id": "example",
      "event_type": "domain",
      "status": "pending",
      "attempts": 1,
      "next_attempt_at": "2026-08-27T12:00:00Z",
      "last_attempt_at": "2026-08-27T12:00:00Z",
      "response_status": 1,
      "last_error": "example",
      "credits_charged": 1,
      "refunded": false,
      "created_at": "2026-08-27T12:00:00Z",
      "delivered_at": "2026-08-27T12:00:00Z"
    }
  ]
}
```

#### HTTP durum kodları

- `200` OK
- `400` Hatalı İstek
- `401` Yetkisiz
- `404` Bulunamadı
- `429` Çok Fazla İstek

## GET `/v1/watchlist/alerts`

İşlem: `listWatchlistAlerts`
Krediler ve kimlik doğrulama: Ücretsiz
Kimlik doğrulama gerekli

GET /v1/watchlist/alerts Kredi: 0

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `subscriptions[]` | object[] |
| `subscriptions[]` | object |
| `subscriptions[].id` | string |
| `subscriptions[].type` | string |
| `subscriptions[].target` | string |
| `subscriptions[].registrar` | string \| null |
| `subscriptions[].events[]` | string[] |
| `subscriptions[].status` | string |
| `subscriptions[].ssl_expiring_days` | integer \| null |
| `subscriptions[].price_type` | string \| null |
| `subscriptions[].drop_percent` | number \| null |
| `subscriptions[].target_price` | number \| null |
| `subscriptions[].currency` | string \| null |
| `subscriptions[].record_types[]` | string[] |
| `subscriptions[].attributes[]` | string[] |
| `subscriptions[].notify_email` | string \| null |
| `subscriptions[].observed` | object \| null |
| `subscriptions[].last_check_at` | string \| null |
| `subscriptions[].last_check_status` | string \| null |
| `subscriptions[].last_error` | string \| null |
| `subscriptions[].next_check_at` | string \| null |
| `subscriptions[].created_at` | string |
| `subscriptions[].updated_at` | string |
| `total` | integer |
| `available_types` | object |
| `available_types.ssl[]` | string[] |
| `available_types.price[]` | string[] |
| `available_types.dns[]` | string[] |
| `available_types.typosquat[]` | string[] |
| `available_types.brand[]` | string[] |
| `policy` | object |
| `policy.credits_per_delivered_alert` | integer |
| `policy.check_credits` | integer |
| `policy.unknown_checks_charged` | boolean |
| `policy.max_subscriptions` | integer |
| `policy.max_typosquat_subscriptions` | integer |
| `policy.max_brand_subscriptions` | integer |
| `policy.brand_attributes[]` | string[] |
| `policy.ssl_expiring_days[]` | integer[] |
| `policy.default_ssl_expiring_days` | integer |
| `policy.record_types[]` | string[] |
| `policy.price_types[]` | string[] |
| `policy.check_interval_minutes` | object |
| `policy.confirmation_checks` | object |

#### Örnek istek

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/watchlist/alerts"
```

```javascript
const response = await fetch("https://domscan.net/v1/watchlist/alerts", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/watchlist/alerts",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/watchlist/alerts", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/watchlist/alerts")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

#### Örnek yanıt

```json
{
  "subscriptions": [
    {
      "id": "example-id",
      "type": "ssl",
      "target": "example",
      "registrar": "example",
      "events": [
        "ssl.expiring"
      ],
      "status": "active",
      "ssl_expiring_days": 30,
      "price_type": "registration",
      "drop_percent": 0.5,
      "target_price": 0.5,
      "currency": "USD",
      "record_types": [
        "A"
      ],
      "attributes": [
        "logo"
      ],
      "notify_email": "user@example.com",
      "observed": {},
      "last_check_at": "2026-08-27T12:00:00Z",
      "last_check_status": "baseline",
      "last_error": "example",
      "next_check_at": "2026-08-27T12:00:00Z",
      "created_at": "2026-08-27T12:00:00Z",
      "updated_at": "2026-08-27T12:00:00Z"
    }
  ],
  "total": 1,
  "available_types": {
    "ssl": [
      "ssl.expiring"
    ],
    "price": [
      "price.dropped"
    ],
    "dns": [
      "dns.changed"
    ],
    "typosquat": [
      "typosquat.detected"
    ],
    "brand": [
      "brand.updated"
    ]
  },
  "policy": {
    "credits_per_delivered_alert": 2,
    "check_credits": 0,
    "unknown_checks_charged": false,
    "max_subscriptions": 1,
    "check_interval_minutes": {},
    "max_typosquat_subscriptions": 1,
    "max_brand_subscriptions": 1,
    "brand_attributes": [
      "logo"
    ],
    "ssl_expiring_days": [
      1
    ],
    "default_ssl_expiring_days": 1,
    "record_types": [
      "A"
    ],
    "price_types": [
      "registration"
    ],
    "confirmation_checks": {}
  }
}
```

#### HTTP durum kodları

- `200` OK
- `401` Yetkisiz
- `429` Çok Fazla İstek

## POST `/v1/watchlist/alerts`

İşlem: `createWatchlistAlert`
Krediler ve kimlik doğrulama: Ücretsiz
Kimlik doğrulama gerekli

POST /v1/watchlist/alerts Kredi: 0

#### Gövde parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| type | string İzin verilen değerler `ssl`, `price`, `dns`, `typosquat`, `brand` | gerekli |
| domain | string | isteğe bağlı |
| tld | string | isteğe bağlı |
| registrar | string \| null | isteğe bağlı |
| events | string[] İzin verilen değerler `ssl.expiring`, `ssl.expired`, `ssl.changed`, `price.dropped`, `dns.changed`, `typosquat.detected`, `brand.updated` | isteğe bağlı |
| ssl_expiring_days | integer İzin verilen değerler `30`, `14`, `7`, `1` Varsayılan `14` | isteğe bağlı |
| price_type | string İzin verilen değerler `registration`, `renewal` Varsayılan `registration` | isteğe bağlı |
| drop_percent | number \| null | isteğe bağlı |
| target_price | number \| null | isteğe bağlı |
| record_types | string[] İzin verilen değerler `A`, `AAAA`, `MX`, `NS`, `TXT`, `CNAME` | isteğe bağlı |
| attributes | string[] İzin verilen değerler `logo`, `wide_logo`, `colors`, `name`, `socials` | isteğe bağlı |
| notify_email | string \| null | isteğe bağlı |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `subscription` | object |
| `subscription.id` | string |
| `subscription.type` | string |
| `subscription.target` | string |
| `subscription.registrar` | string \| null |
| `subscription.events[]` | string[] |
| `subscription.status` | string |
| `subscription.ssl_expiring_days` | integer \| null |
| `subscription.price_type` | string \| null |
| `subscription.drop_percent` | number \| null |
| `subscription.target_price` | number \| null |
| `subscription.currency` | string \| null |
| `subscription.record_types[]` | string[] |
| `subscription.attributes[]` | string[] |
| `subscription.notify_email` | string \| null |
| `subscription.observed` | object \| null |
| `subscription.last_check_at` | string \| null |
| `subscription.last_check_status` | string \| null |
| `subscription.last_error` | string \| null |
| `subscription.next_check_at` | string \| null |
| `subscription.created_at` | string |
| `subscription.updated_at` | string |

#### Örnek istek

```bash
curl -X POST "https://domscan.net/v1/watchlist/alerts" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "type": "ssl",
  "domain": "shop.example.com",
  "events": [
    "ssl.expiring",
    "ssl.changed"
  ],
  "ssl_expiring_days": 14
}'
```

```javascript
const response = await fetch("https://domscan.net/v1/watchlist/alerts", {
  method: "POST",
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "type": "ssl",
    "domain": "shop.example.com",
    "events": [
      "ssl.expiring",
      "ssl.changed"
    ],
    "ssl_expiring_days": 14
  }),
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.post(
    "https://domscan.net/v1/watchlist/alerts",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
    json={
        "type": "ssl",
        "domain": "shop.example.com",
        "events": [
            "ssl.expiring",
            "ssl.changed",
        ],
        "ssl_expiring_days": 14,
    },
)
print(response.json())
```

```go
package main

func main() {
	body := strings.NewReader(`{
	  "type": "ssl",
	  "domain": "shop.example.com",
	  "events": [
	    "ssl.expiring",
	    "ssl.changed"
	  ],
	  "ssl_expiring_days": 14
	}`)
	req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/watchlist/alerts", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/watchlist/alerts")
request = Net::HTTP::Post.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
  "type" => "ssl",
  "domain" => "shop.example.com",
  "events" => [
    "ssl.expiring",
    "ssl.changed"
  ],
  "ssl_expiring_days" => 14
})

#### Örnek yanıt

```json
{
  "subscription": {
    "id": "example-id",
    "type": "ssl",
    "target": "example",
    "registrar": "example",
    "events": [
      "ssl.expiring"
    ],
    "status": "active",
    "ssl_expiring_days": 30,
    "price_type": "registration",
    "drop_percent": 0.5,
    "target_price": 0.5,
    "currency": "USD",
    "record_types": [
      "A"
    ],
    "attributes": [
      "logo"
    ],
    "notify_email": "user@example.com",
    "observed": {},
    "last_check_at": "2026-08-27T12:00:00Z",
    "last_check_status": "baseline",
    "last_error": "example",
    "next_check_at": "2026-08-27T12:00:00Z",
    "created_at": "2026-08-27T12:00:00Z",
    "updated_at": "2026-08-27T12:00:00Z"
  }
}
```

#### HTTP durum kodları

- `201` Oluşturuldu
- `400` Hatalı İstek
- `401` Yetkisiz
- `409` HTTP 409
- `429` Çok Fazla İstek

## GET `/v1/watchlist/alerts/:subscription_id`

İşlem: `getWatchlistAlert`
Krediler ve kimlik doğrulama: Ücretsiz
Kimlik doğrulama gerekli

GET /v1/watchlist/alerts/:subscription_id Kredi: 0

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| subscription_id | string | gerekli |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `subscription` | object |
| `subscription.id` | string |
| `subscription.type` | string |
| `subscription.target` | string |
| `subscription.registrar` | string \| null |
| `subscription.events[]` | string[] |
| `subscription.status` | string |
| `subscription.ssl_expiring_days` | integer \| null |
| `subscription.price_type` | string \| null |
| `subscription.drop_percent` | number \| null |
| `subscription.target_price` | number \| null |
| `subscription.currency` | string \| null |
| `subscription.record_types[]` | string[] |
| `subscription.attributes[]` | string[] |
| `subscription.notify_email` | string \| null |
| `subscription.observed` | object \| null |
| `subscription.last_check_at` | string \| null |
| `subscription.last_check_status` | string \| null |
| `subscription.last_error` | string \| null |
| `subscription.next_check_at` | string \| null |
| `subscription.created_at` | string |
| `subscription.updated_at` | string |
| `events[]` | object[] |
| `events[]` | object |
| `events[].id` | string |
| `events[].event_type` | string |
| `events[].detected_at` | string |
| `events[].published_at` | string \| null |
| `events[].data` | object |

#### Örnek istek

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/watchlist/alerts/string"
```

```javascript
const response = await fetch("https://domscan.net/v1/watchlist/alerts/string", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/watchlist/alerts/string",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

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

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/watchlist/alerts/string", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/watchlist/alerts/string")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

#### Örnek yanıt

```json
{
  "subscription": {
    "id": "example-id",
    "type": "ssl",
    "target": "example",
    "registrar": "example",
    "events": [
      "ssl.expiring"
    ],
    "status": "active",
    "ssl_expiring_days": 30,
    "price_type": "registration",
    "drop_percent": 0.5,
    "target_price": 0.5,
    "currency": "USD",
    "record_types": [
      "A"
    ],
    "attributes": [
      "logo"
    ],
    "notify_email": "user@example.com",
    "observed": {},
    "last_check_at": "2026-08-27T12:00:00Z",
    "last_check_status": "baseline",
    "last_error": "example",
    "next_check_at": "2026-08-27T12:00:00Z",
    "created_at": "2026-08-27T12:00:00Z",
    "updated_at": "2026-08-27T12:00:00Z"
  },
  "events": [
    {
      "id": "example-id",
      "event_type": "ssl.expiring",
      "detected_at": "2026-08-27T12:00:00Z",
      "published_at": "2026-08-27T12:00:00Z",
      "data": {}
    }
  ]
}
```

#### HTTP durum kodları

- `200` OK
- `401` Yetkisiz
- `404` Bulunamadı
- `429` Çok Fazla İstek

## PATCH `/v1/watchlist/alerts/:subscription_id`

İşlem: `updateWatchlistAlert`
Krediler ve kimlik doğrulama: Ücretsiz
Kimlik doğrulama gerekli

PATCH /v1/watchlist/alerts/:subscription_id Kredi: 0

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| subscription_id | string | gerekli |

#### Gövde parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| enabled | boolean | isteğe bağlı |
| events | string[] İzin verilen değerler `ssl.expiring`, `ssl.expired`, `ssl.changed`, `price.dropped`, `dns.changed`, `typosquat.detected`, `brand.updated` | isteğe bağlı |
| ssl_expiring_days | integer İzin verilen değerler `30`, `14`, `7`, `1` | isteğe bağlı |
| drop_percent | number \| null | isteğe bağlı |
| target_price | number \| null | isteğe bağlı |
| record_types | string[] İzin verilen değerler `A`, `AAAA`, `MX`, `NS`, `TXT`, `CNAME` | isteğe bağlı |
| attributes | string[] İzin verilen değerler `logo`, `wide_logo`, `colors`, `name`, `socials` | isteğe bağlı |
| notify_email | string \| null | isteğe bağlı |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `subscription` | object |
| `subscription.id` | string |
| `subscription.type` | string |
| `subscription.target` | string |
| `subscription.registrar` | string \| null |
| `subscription.events[]` | string[] |
| `subscription.status` | string |
| `subscription.ssl_expiring_days` | integer \| null |
| `subscription.price_type` | string \| null |
| `subscription.drop_percent` | number \| null |
| `subscription.target_price` | number \| null |
| `subscription.currency` | string \| null |
| `subscription.record_types[]` | string[] |
| `subscription.attributes[]` | string[] |
| `subscription.notify_email` | string \| null |
| `subscription.observed` | object \| null |
| `subscription.last_check_at` | string \| null |
| `subscription.last_check_status` | string \| null |
| `subscription.last_error` | string \| null |
| `subscription.next_check_at` | string \| null |
| `subscription.created_at` | string |
| `subscription.updated_at` | string |

#### Örnek istek

```bash
curl -X PATCH "https://domscan.net/v1/watchlist/alerts/string" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "enabled": true,
  "events": [
    "ssl.expiring",
    "ssl.expired",
    "ssl.changed"
  ]
}'
```

```javascript
const response = await fetch("https://domscan.net/v1/watchlist/alerts/string", {
  method: "PATCH",
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "enabled": true,
    "events": [
      "ssl.expiring",
      "ssl.expired",
      "ssl.changed"
    ]
  }),
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.patch(
    "https://domscan.net/v1/watchlist/alerts/string",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
    json={
        "enabled": True,
        "events": [
            "ssl.expiring",
            "ssl.expired",
            "ssl.changed",
        ],
    },
)
print(response.json())
```

```go
package main

func main() {
	body := strings.NewReader(`{
	  "enabled": true,
	  "events": [
	    "ssl.expiring",
	    "ssl.expired",
	    "ssl.changed"
	  ]
	}`)
	req, err := http.NewRequest(http.MethodPatch, "https://domscan.net/v1/watchlist/alerts/string", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/watchlist/alerts/string")
request = Net::HTTP::Patch.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
  "enabled" => true,
  "events" => [
    "ssl.expiring",
    "ssl.expired",
    "ssl.changed"
  ]
})

#### Örnek yanıt

```json
{
  "subscription": {
    "id": "example-id",
    "type": "ssl",
    "target": "example",
    "registrar": "example",
    "events": [
      "ssl.expiring"
    ],
    "status": "active",
    "ssl_expiring_days": 30,
    "price_type": "registration",
    "drop_percent": 0.5,
    "target_price": 0.5,
    "currency": "USD",
    "record_types": [
      "A"
    ],
    "attributes": [
      "logo"
    ],
    "notify_email": "user@example.com",
    "observed": {},
    "last_check_at": "2026-08-27T12:00:00Z",
    "last_check_status": "baseline",
    "last_error": "example",
    "next_check_at": "2026-08-27T12:00:00Z",
    "created_at": "2026-08-27T12:00:00Z",
    "updated_at": "2026-08-27T12:00:00Z"
  }
}
```

#### HTTP durum kodları

- `200` OK
- `400` Hatalı İstek
- `401` Yetkisiz
- `404` Bulunamadı
- `429` Çok Fazla İstek

## DELETE `/v1/watchlist/alerts/:subscription_id`

İşlem: `deleteWatchlistAlert`
Krediler ve kimlik doğrulama: Ücretsiz
Kimlik doğrulama gerekli

DELETE /v1/watchlist/alerts/:subscription_id Kredi: 0

#### Sorgu parametreleri

| Parametre | Tür | gerekli |
| --- | --- | --- |
| subscription_id | string | gerekli |

#### Yanıt alanları

| Alan | Tür |
| --- | --- |
| `id` | string |
| `deleted` | boolean |

#### Örnek istek

```bash
curl -X DELETE "https://domscan.net/v1/watchlist/alerts/string" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{}'
```

```javascript
const response = await fetch("https://domscan.net/v1/watchlist/alerts/string", {
  method: "DELETE",
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({}),
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.delete(
    "https://domscan.net/v1/watchlist/alerts/string",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
    json={},
)
print(response.json())
```

```go
package main

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

func main() {
	body := strings.NewReader(`{}`)
	req, err := http.NewRequest(http.MethodDelete, "https://domscan.net/v1/watchlist/alerts/string", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
```

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/watchlist/alerts/string")
request = Net::HTTP::Delete.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))
```

#### Örnek yanıt

```json
{
  "id": "example-id",
  "deleted": true
}
```

#### HTTP durum kodları

- `200` OK
- `401` Yetkisiz
- `404` Bulunamadı
- `429` Çok Fazla İstek

## Referans kaynakları

[OpenAPI 3.0](https://domscan.net/v1/openapi.json)
[Postman](https://domscan.net/v1/postman.json)
[MCP](https://domscan.net/tr/mcp-domain-checker)
