# API Overview

#### Introduction

The TAGBASE API enables developers to:

* **Query claims** — Retrieve claims associated with URLs
* **Fetch verifications** — Get verification details by ID
* **Initiate ownership challenges** — Request wallet signature verification
* **Submit ownership proofs** — Validate blockchain ownership

***

#### Base URL

```
https://api.extension.tagbase.io
```

***

#### Authentication

**No authentication required.** The TAGBASE API is fully public and accessible without API keys.

***

#### CORS Support

The API supports cross-origin requests from any domain:

```
Access-Control-Allow-Origin: *
```

***

#### Response Format

All responses are JSON:

**Success Response:**

```json
{
  "claims": [ ... ]
}
```

**Error Response:**

```json
{
  "error": "resource_url is required"
}
```

***

#### Core Endpoints

| Endpoint                  | Method | Description                 |
| ------------------------- | ------ | --------------------------- |
| /claims?resource\_url=... | GET    | Get claims for a URL        |
| /verifications/{id}       | GET    | Get verification by ID      |
| /ownership/challenge      | POST   | Request ownership challenge |
| /ownership/proof/ethereum | POST   | Submit Ethereum proof       |
| /ownership/proof/cardano  | POST   | Submit Cardano proof        |

***

#### Quick Start Examples

**Fetch Claims for a URL:**

```bash
curl "https://api.extension.tagbase.io/claims?resource_url=https://example.com/product"
```

**Fetch a Verification:**

```bash
curl "https://api.extension.tagbase.io/verifications/VRF_abc123def456"
```

<br>