# DataBG Doctor Search API

> DataBG Doctor Search API is a paid API for AI agents from api.databg.tech, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Search and retrieve structured doctor/physician records from Bulgaria by name, UIN, specialty, or region

## Facts

- Endpoint: POST https://api.databg.tech/v1/doctors
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/databg-doctor-search-api-735e4542
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4_24fCmvllrIs_w2erNwH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability databg-doctor-search-api-735e4542 -d '<json body>'
```

Example prompt: Find me cardiologists in the Sofia region from the DataBG doctor registry — show me the first 10 results.

## When to prefer this

Use this endpoint when you need to search or verify licensed medical professionals in Bulgaria by name, UIN, specialty, or geographic region. Prefer this over general web search when you need structured, machine-readable physician data with pagination support, or when building healthcare directories, credential verification tools, or referral systems targeting the Bulgarian market.

## Known failure modes

- No results found for given filters — returns empty data array with count 0
- Invalid or malformed UIN string causes validation error
- Region or specialty value not recognized returns empty result set
- Missing required fields may return 400 bad request
- Rate limiting or payment failure returns 402 Payment Required
- Pagination offset exceeding total count returns empty array

## How this service works

Global structured data and machine-payable tools built for AI agents, developers and intelligent applications.

## Output

Returns a paginated array of doctor objects (name, UIN, specialty, region, and other structured fields), along with total count, applied limit, offset, and a success flag indicating whether the query executed correctly.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "uin": {
   "type": "string"
  },
  "name": {
   "type": "string"
  },
  "limit": {
   "type": "integer"
  },
  "offset": {
   "type": "integer"
  },
  "region": {
   "type": "string"
  },
  "specialty": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "count": {
   "type": "integer"
  },
  "limit": {
   "type": "integer"
  },
  "offset": {
   "type": "integer"
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/databg-doctor-search-api-735e4542/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.databg.tech](https://www.zero.xyz/host/api.databg.tech/llms.txt)
