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

# Registry Registration

> Register your gateway in the Commerce Registry for @shop discovery

# Registry Registration

Register your AI Gateway in the Commerce Registry to enable `@shop` discovery across AI assistants.

## Why Register?

* 🔍 **Discoverability**: Users can find your products via `@shop Your Brand`
* ✅ **Verification**: Build trust with verified brand status
* 📊 **Analytics**: Track discovery and usage metrics
* 🔗 **Universal Access**: Works with all major AI assistants

## Registration Process

### Step 1: Prepare Gateway Information

```json theme={null}
{
  "brand_name": "Your Brand Name",
  "domain": "yourstore.com",
  "endpoint": "https://gateway.betterdata.co/v1/your-gateway-id",
  "description": "Brief description of your brand",
  "logo_url": "https://yourstore.com/logo.png",
  "categories": ["fashion", "beauty"],
  "verified": false
}
```

### Step 2: Submit Registration

```bash theme={null}
curl -X POST https://registry.betterdata.co/api/gateways \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_name": "Your Brand",
    "domain": "yourstore.com",
    "endpoint": "https://gateway.betterdata.co/v1/your-gateway-id",
    "description": "Premium beauty products",
    "logo_url": "https://yourstore.com/logo.png",
    "categories": ["beauty", "cosmetics"]
  }'
```

**Response:**

```json theme={null}
{
  "id": "gw_123",
  "brand_name": "Your Brand",
  "domain": "yourstore.com",
  "endpoint": "https://gateway.betterdata.co/v1/your-gateway-id",
  "verified": false,
  "status": "pending",
  "created_at": "2024-01-15T10:00:00Z"
}
```

### Step 3: Verification (Optional)

To get verified status:

1. Verify domain ownership (DNS TXT record)
2. Complete brand verification process
3. Wait for manual review (1-2 business days)

## Discovery Queries

Once registered, users can discover your products via:

* `@shop Your Brand` - Browse your catalog
* `@shop Your Brand lipstick` - Search your products
* `@shop 012345678901` - Lookup by GTIN/UPC (if configured)

***

## Related Pages

* [Registry Management](/reference/reference/ai-registry/registry/management)
* [Getting Started](/hosted/ai-registry/getting-started)