API Reference

Complete API documentation for verified.md endpoints.

Base URL

https://verified.md

Authentication

No authentication required. All read endpoints are public.

Endpoints

Endpoint	Method	Description
`/verify/{domain}`	GET	Check if domain is verified
`/lookup/{entity-id}`	GET	Reverse lookup by entity ID
`/status`	GET	Health check

GET /verify/{domain}

Primary verification endpoint. Check if a domain is trusted.

curl https://verified.md/verify/stripe.com

Response (Verified)

{
  "success": true,
  "data": {
    "domain": "stripe.com",
    "verified": true,
    "entity": {
      "name": "Stripe Inc",
      "id": "ent_stripe001",
      "level": "verified",
      "type": "api"
    }
  }
}

Response (Not Found)

{
  "success": true,
  "data": {
    "domain": "unknown.com",
    "verified": false,
    "entity": null
  }
}

Error Codes

Code	HTTP	Description
`NOT_FOUND`	404	Entity not in registry
`VALIDATION_ERROR`	400	Invalid input format
`INTERNAL_ERROR`	500	Server error

Rate Limits

No rate limits during beta. Future tiers: Free (1K/day), Pro (100K/day), Enterprise (unlimited).

Agent format: /api.md