> ## Documentation Index
> Fetch the complete documentation index at: https://docs.defendis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

Defendis API lets you integrate external threat signals into your product and security workflows to automate monitoring and enrichment. Use this API to:

<Columns cols={1}>
  <Card icon="search" horizontal title="Search for leaks">
    Query data leak signals for approved identifiers (domains, BINs, etc).
  </Card>

  <Card icon="list" horizontal title="Manage Watchlists">
    Create and manage watchlists that define what you monitor.
  </Card>

  <Card icon="server" horizontal title="Exposure Analysis">
    Analyse your external exposure and track ransomware activity.
  </Card>
</Columns>

## Base URL and versioning

* Base URL: `https://api.defendis.ai`
* Version prefix: `/api/v1`

Example endpoint: `https://api.defendis.ai/api/v1/watchlists`

## Authentication

All `/api/v1/*` endpoints require an API key:

```http theme={null}
Authorization: Bearer <api_key>
```

## Start here

<Columns cols={2}>
  <Card title="Getting Started" href="/api/getting-started">
    Make your first request and learn integration patterns.
  </Card>

  <Card title="Authentication" href="/api/auth">
    API keys, authorization scope, and security best practices.
  </Card>

  <Card title="Endpoints" href="/api/endpoints">
    Guidance on which endpoint family to use, with OpenAPI reference.
  </Card>

  <Card title="Errors" href="/api/errors">
    Error model, retry behavior, and troubleshooting.
  </Card>

  <Card title="Deployment" href="/api/deployment">
    Availability, versioning policy, and change management.
  </Card>
</Columns>

## Downloads

* Download the <a href="/postman/defendis_api_postman.json?download=1" download="defendis_api_postman.json">`Postman file`</a>
* Import the OpenAPI spec URL: `https://api.defendis.ai/openapi.json`