POST
https://jmpy.me/api/v1
/
domains
/
branded
/
{id}
/
verify
Verify Branded Domain
curl --request POST \
  --url https://jmpy.me/api/v1/domains/branded/{id}/verify \
  --header 'Authorization: Bearer <token>'
Trigger a DNS verification check for a branded domain. You must first configure your DNS records (TXT for ownership, A/CNAME for routing).

Path Parameters

id
string
required
The UUID of the branded domain.

Request Examples

curl -X POST "https://jmpy.me/api/v1/domains/branded/YOUR_DOMAIN_ID/verify" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Examples

{
  "success": true,
  "data": {
    "domain": {
         "id": "uuid",
         "domain": "go.acme.com",
         "is_verified": true
    },
    "verification": {
         "ok": true,
         "message": "Domain verified successfully!"
    }
  }
}

Use Cases

Periodically check if verification is complete after DNS setup.
async function waitForVerification(domainId, maxAttempts = 10) {
  for (let i = 0; i < maxAttempts; i++) {
    // Trigger verification check
    const response = await fetch(
      `https://jmpy.me/api/v1/domains/branded/${domainId}/verify`,
      { 
        method: 'POST',
        headers: { 'Authorization': 'Bearer YOUR_API_KEY' } 
      }
    );
    const result = await response.json();

    if (result.success && result.data.domain.is_verified) {
      console.log('Domain successfully verified!');
      return true;
    }

    // Wait 30 seconds before next try
    await new Promise(r => setTimeout(r, 30000));
  }
  
  return false; // Timed out
}