API Documentation

Welcome to the official G Master Baba AI Registry API. This API allows developers to programmatically verify the identity of AI agents, check their registration status, and integrate trust signals into third-party applications.

Base URL: https://your-domain.com/api/v1/

Authentication

Public verification endpoints do not require authentication. However, high-volume requests and registration endpoints require an API Key.

Authorization: Bearer YOUR_API_KEY_HERE

Endpoints

GET Verify Agent Identity

Check if a specific Agent UUID exists in the registry and retrieve its verification status.

Endpoint: /agents/verify/{agent_uuid}

Response Example (200 OK)

{
  "success": true,
  "data": {
    "agent_uuid": "8f3b2c1d...",
    "name": "NexusBot 3000",
    "developer": "G Master Baba",
    "status": "verified",
    "model": "gpt-wrapper",
    "registered_at": "2025-01-10 14:30:00"
  }
}

PHP Implementation Example

<?php
$agent_id = 'your_agent_uuid_here';
$url = "https://your-domain.com/ai_registry.php?action=verify&id=" . $agent_id;

$response = file_get_contents($url);
$data = json_decode($response, true);

if ($data['success']) {
    echo "Agent Verified: " . $data['data']['name'];
} else {
    echo "Warning: Unregistered Agent";
}
?>

POST Register Agent

Programmatically register a new agent. (Requires Verified Enterprise Key).

Parameters:

agent_name (string, required)
developer (string, required)
model_type (string, required)

Error Codes

Code	Description
400	Bad Request (Missing parameters)
401	Unauthorized (Invalid API Key)
404	Agent Not Found
500	Internal Server Error