Email Finding Inquiry
Returns the results of an email finding job by its ID. Use this to poll for results or retrieve them after your webhook has been called.
Pricing: Free (0 credits) — checking results does not cost credits.
curl -X GET "https://v3-api.texau.com/api/v1/email_finding_inquiry/1ea83076-8a42-47c1-bd2b-25da8085b3a7" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY"
import requests
import json
url = "https://v3-api.texau.com/api/v1/email_finding_inquiry/1ea83076-8a42-47c1-bd2b-25da8085b3a7"
headers = {
"Content-Type": "application/json",
"x-api-key": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://v3-api.texau.com/api/v1/email_finding_inquiry/1ea83076-8a42-47c1-bd2b-25da8085b3a7", {
method: "GET",
headers: {
"Content-Type": "application/json",
"x-api-key": "YOUR_API_KEY"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://v3-api.texau.com/api/v1/email_finding_inquiry/1ea83076-8a42-47c1-bd2b-25da8085b3a7", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("x-api-key", "YOUR_API_KEY")
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://v3-api.texau.com/api/v1/email_finding_inquiry/1ea83076-8a42-47c1-bd2b-25da8085b3a7')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['x-api-key'] = 'YOUR_API_KEY'
response = http.request(request)
puts response.body
{
"id": "1ea83076-8a42-47c1-bd2b-25da8085b3a7",
"state": "DONE",
"data": [
{
"refId": "ref-001",
"state": "DONE",
"input": {
"firstname": "Linda",
"lastname": "Smith",
"domain": "acme.com"
},
"output": [
{
"address": "[email protected]",
"status": "VALID",
"subStatus": "SMTP",
"free": false,
"found": true
}
]
},
{
"refId": "ref-002",
"state": "DONE",
"input": {
"firstname": "John",
"lastname": "Doe",
"domain": "acme.com"
},
"output": [
{
"address": "[email protected]",
"status": "INVALID",
"subStatus": "MAILBOX_NOT_FOUND",
"free": false,
"found": false
}
]
}
]
}
{
"error": "Forbidden",
"message": "You don't have permission to access this resource",
"code": 403
}
{
"error": "Too Many Requests",
"message": "Rate limit exceeded. Please try again later",
"code": 429,
"retryAfter": 3600
}
GET
/email_finding_inquiry/{id}GET
API Key (header: x-api-key)
x-api-keystring
RequiredYour TexAu API key. Contact TexAu to obtain one.
Your TexAu API key. Contact TexAu to obtain one.
path
idstring
RequiredThe job ID returned from the Email Finding endpoint
Request Preview
Response
Response will appear here after sending the request
Authentication
header
x-api-keystring
RequiredAPI Key for authentication. Your TexAu API key. Contact TexAu to obtain one.
Path Parameters
idstring
RequiredThe job ID returned from the Email Finding endpoint
Responses
idstring
statestring
Allowed values:
DONEPROCESSINGFAILEDdataarray
refIdstring
statestring
inputobject
firstnamestring
lastnamestring
domainstring
outputarray
addressstring
The found email address
statusstring
Allowed values:
VALIDINVALIDCATCH_ALLUNKNOWNsubStatusstring
freeboolean
Whether this is a free email provider
foundboolean
Whether the email was found
messagestring
errorstring
apistring
limitinteger
currentinteger
Was this page helpful?
Last updated 2 weeks ago
Built with Documentation.AI