Confirm alias creation or removal via query token
Executes the confirmation. Functionally identical to POST but accepts the token as a query parameter.
curl -X GET "https://mail.haltman.io/api/forward/confirm?token=example_string" \
-H "Content-Type: application/json"
import requests
import json
url = "https://mail.haltman.io/api/forward/confirm?token=example_string"
headers = {
"Content-Type": "application/json"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://mail.haltman.io/api/forward/confirm?token=example_string", {
method: "GET",
headers: {
"Content-Type": "application/json"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://mail.haltman.io/api/forward/confirm?token=example_string", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://mail.haltman.io/api/forward/confirm?token=example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
response = http.request(request)
puts response.body
{
"ok": true,
"confirmed": true,
"intent": "subscribe",
"created": true,
"removed": true,
"reason": "example_string",
"address": "123 Main St",
"goto": "example_string"
}
{
"error": "example_string",
"field": "example_string",
"reason": "example_string",
"hint": "example_string",
"constraints": {}
}
{
"error": "example_string"
}
{
"error": "example_string",
"ban": {},
"type": "example_string",
"value": "example_string"
}
{
"error": "Not Found",
"message": "The requested resource was not found",
"code": 404
}
{
"error": "Conflict",
"message": "The request conflicts with the current state of the resource",
"code": 409,
"details": "Resource already exists"
}
{
"error": "example_string",
"where": "example_string",
"reason": "example_string"
}
{
"error": "Internal Server Error",
"message": "An unexpected error occurred on the server",
"code": 500,
"requestId": "req_1234567890"
}
GET
/api/forward/confirm
Request Preview
Response
Response will appear here after sending the request
Query Parameters
Responses
okboolean
Requiredconfirmedboolean
Requiredintentstring
RequiredAllowed values:
subscribeunsubscribecreatedboolean
removedboolean
reasonstring
addressstring
Requiredgotostring
errorstring
Requiredfieldstring
reasonstring
hintstring
constraintsobject
errorstring
Requirederrorstring
Requiredbanobject
typestring
valuestring
errorstring
Requirederrorstring
Requirederrorstring
Requiredwherestring
reasonstring
errorstring
RequiredWas this page helpful?
Last updated Apr 9, 2026
Built with Documentation.AI