curl --request DELETE \
--url https://api-sandbox.letshum.com/sessions/{token} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-sandbox.letshum.com/sessions/{token}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-sandbox.letshum.com/sessions/{token}', 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-sandbox.letshum.com/sessions/{token}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-sandbox.letshum.com/sessions/{token}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api-sandbox.letshum.com/sessions/{token}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.letshum.com/sessions/{token}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"message": "Session closed successfully.",
"request_status": "ok",
"data": {
"session_token": "SESSION_TOKEN_PLACEHOLDER"
},
"meta": {
"session_token": "SESSION_TOKEN_PLACEHOLDER",
"session_status": "closed",
"session_params": {
"street1": "29090 Tiffany Dr E",
"street2": null,
"city": "Southfield",
"state": "MI",
"zip": "48034",
"latitude": "42.50189",
"longitude": "-83.29528",
"campaign_id": null
},
"service_address": "29090 Tiffany Dr E, Southfield, MI 48034-4540",
"mdu": false,
"agent_status": {
"geocoding": "matched",
"internet": "matched",
"checkout": "pending"
},
"created_at": "2026-07-13T12:26:15.618-04:00",
"updated_at": "2026-07-13T12:27:33.031-04:00",
"responded_at": "2026-07-13T16:27:33.185Z",
"hum_data_set": "26011015"
}
}Close Session
Closes an active session. Sessions remain open until this endpoint is called.
Closing Behavior
- The response returns the session envelope with
meta.session_statusset toclosed - Subsequent operations on the closed session return HTTP 410
When to Close
- After completing service lookup
- When switching to a different address
- After receiving final results
- When abandoning a search
Important Notes
- A closed session cannot be reopened
- Create a new session to perform another lookup
curl --request DELETE \
--url https://api-sandbox.letshum.com/sessions/{token} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-sandbox.letshum.com/sessions/{token}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-sandbox.letshum.com/sessions/{token}', 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-sandbox.letshum.com/sessions/{token}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-sandbox.letshum.com/sessions/{token}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api-sandbox.letshum.com/sessions/{token}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.letshum.com/sessions/{token}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"message": "Session closed successfully.",
"request_status": "ok",
"data": {
"session_token": "SESSION_TOKEN_PLACEHOLDER"
},
"meta": {
"session_token": "SESSION_TOKEN_PLACEHOLDER",
"session_status": "closed",
"session_params": {
"street1": "29090 Tiffany Dr E",
"street2": null,
"city": "Southfield",
"state": "MI",
"zip": "48034",
"latitude": "42.50189",
"longitude": "-83.29528",
"campaign_id": null
},
"service_address": "29090 Tiffany Dr E, Southfield, MI 48034-4540",
"mdu": false,
"agent_status": {
"geocoding": "matched",
"internet": "matched",
"checkout": "pending"
},
"created_at": "2026-07-13T12:26:15.618-04:00",
"updated_at": "2026-07-13T12:27:33.031-04:00",
"responded_at": "2026-07-13T16:27:33.185Z",
"hum_data_set": "26011015"
}
}Authorizations
Bearer token authentication using API tokens.
Include the token in the Authorization header as: Authorization: Bearer <token>
Obtain tokens from your Hum representative or contact support@letshum.com. There is no self-serve API key dashboard.
Path Parameters
The session token identifying the specific session The session token provided by the Hum API. Used to connect the response to the session in the client system.
"XqCmeTVgYXrbWrZFZEymkD"
Response
Session closed successfully
"Session closed successfully."
An informational summary returned in API response bodies: ok for successful responses, warning for standard request errors, and error for endpoint-specific failures. Integrations must use the HTTP status code, not request_status, to determine whether a request succeeded.
ok, warning, error "ok"
Session response data. The formatted service address and normalized address components are returned in meta.
Show child attributes
Show child attributes
Session metadata, including normalized input values, formatted service address, session status, and the Hum data set used for the response.
Show child attributes
Show child attributes
Was this page helpful?
