Verifications

Start domain verification

Start a B2B domain verification. Returns DNS TXT record and HTTP file instructions for the domain owner to complete verification. Automatically detects the DNS provider.

post/api/v1/verifications/domain

Request

  • Base URL: https://api.proof.holdings
  • URL: https://api.proof.holdings/api/v1/verifications/domain
  • Auth: HTTP bearer

Request body

domainstring required

Domain to verify

customer_idstring

Optional customer identifier

verification_method'manual_dns' | 'http_file'

Verification method (default: manual_dns)

Example request

{
  "domain": "example.com",
  "customer_id": "cust_12345",
  "verification_method": "manual_dns"
}

Response

Domain verification started

idstring required

MongoDB ObjectId

domainstring required
status'pending' | 'verified' required
verification_methodstring required

Example response

{
  "id": "507f1f77bcf86cd799439011",
  "domain": "example.com",
  "status": "pending",
  "verification_method": "manual_dns",
  "dns_record": {
    "name": "_proof.example.com",
    "value": "proof-verify=abc123"
  },
  "http_file": {
    "path": "/.well-known/proof-verify.txt",
    "content": "proof-verify=abc123"
  },
  "provider": {
    "detected": "cloudflare",
    "name": "Cloudflare"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.