Skip to main content

Verify your custom domain

Once your DNS provider has registered your TXT value and the change has been propagated, Sovrin must reach out to the public DNS record and confirm the value matches the one set up on your tenant.

Request​

Make the following request to verify your custom domain:

POST https://api.sovrin.one/core/v1/config/domain/verify

Response​

  • 204 response (with no body): Verification successful!

  • 400 response: Indicates that something has gone wrong with the DNS setup. It could be that you need to wait longer to ensure your TXT record has propagated or repeat the process to verify domain ownership.

  • 404 response: Indicates you have not setup a custom domain at all, and must return to the beginning of this guide and configure a custom domain.

What's next?​

Following a successful verification request, when you make a request to retrieve the custom domain:

GET https://api.sovrin.one/core/v1/config/domain

You will see the isVerfied boolean in the response is now true:

{
  "name": "Custom Site",
  "logoUrl": "https://my-custom.site/logo.png",
  "domain": "my-custom.site",
  "verificationToken": "46077231-f7f4-4559-8405-6e875b81805f",
  "isVerified": true,
  "verifiedAt": "2021-05-21T04:02:48.638Z"
}

This means that the custom domain has been properly configured and verified, and is now being used by your Sovrin tenant. To complete the process you must ensure Sovrin assets are available.