logo
EmailEmail Finding Inquiry

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"
{
  "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
        }
      ]
    }
  ]
}
GET
/email_finding_inquiry/{id}
GET
API Key (header: x-api-key)
x-api-keystring
Required

Your TexAu API key. Contact TexAu to obtain one.

Your TexAu API key. Contact TexAu to obtain one.
path
idstring
Required

The job ID returned from the Email Finding endpoint

Request Preview
Response

Response will appear here after sending the request

Authentication

header
x-api-keystring
Required

API Key for authentication. Your TexAu API key. Contact TexAu to obtain one.

Path Parameters

idstring
Required

The job ID returned from the Email Finding endpoint

Responses

idstring
statestring
Allowed values:DONEPROCESSINGFAILED
dataarray