Get Email Verification Status

Check whether a given email address has been verified for Velt workspace ownership using the v2 REST API as part of the workspace signup flow.

POST /v2/workspace/email/status

Get Email Verification Status

cURL

curl --request POST \
  --url https://api.velt.dev/v2/workspace/email/status \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "ownerEmail": "<string>"
  }
}
'

import requests

url = "https://api.velt.dev/v2/workspace/email/status"

payload = { "data": { "ownerEmail": "<string>" } }
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({data: {ownerEmail: '<string>'}})
};

fetch('https://api.velt.dev/v2/workspace/email/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.velt.dev/v2/workspace/email/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'data' => [
        'ownerEmail' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.velt.dev/v2/workspace/email/status"

	payload := strings.NewReader("{\n  \"data\": {\n    \"ownerEmail\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.velt.dev/v2/workspace/email/status")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": {\n    \"ownerEmail\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.velt.dev/v2/workspace/email/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"data\": {\n    \"ownerEmail\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "result": {
    "status": "success",
    "message": "Email verified and workspace reactivated",
    "data": {
      "verified": true
    }
  }
}

Use this API to check whether a given email address has been verified for workspace ownership.

If the email has just been verified, this API also reactivates any API keys that were expired due to the email not being verified.

This is a public endpoint — no authentication headers are required.

Endpoint

POST https://api.velt.dev/v2/workspace/email/status

Body

Params

data · object · required

Show properties

ownerEmail · string · required

Email address to check verification status for.

Example Request

{
  "data": {
    "ownerEmail": "[e-mail]"
  }
}

Example Response

Success Response (verified)

{
  "result": {
    "status": "success",
    "message": "Email verified and workspace reactivated",
    "data": {
      "verified": true
    }
  }
}

Success Response (not yet verified)

{
  "result": {
    "status": "success",
    "message": "Email not yet verified",
    "data": {
      "verified": false
    }
  }
}

Failure Response

If no workspace exists for the email

{
  "error": {
    "status": "NOT_FOUND",
    "message": "User not found"
  }
}

If rate limit exceeded

{
  "error": {
    "status": "RESOURCE_EXHAUSTED",
    "message": "Rate limit exceeded for this endpoint. Try again later."
  }
}

If the status check fails

{
  "error": {
    "status": "INTERNAL",
    "message": "Failed to verify email status"
  }
}

{
  "result": {
    "status": "success",
    "message": "Email verified and workspace reactivated",
    "data": {
      "verified": true
    }
  }
}