Address Finder
List lookups
List your team's most recent Address Finder lookups.
List your team's 50 most recent lookups, newest first.
GET https://platform.scribeless.co/api/address-finder/lookups
Headers
X-API-Key: YOUR_API_KEY
Example request
curl --request GET 'https://platform.scribeless.co/api/address-finder/lookups' \
--header 'X-API-Key: YOUR_API_KEY'
Response
Successful requests return an array. Each item has the same fields as Fetch lookup, plus outcome and input.
[
{
"id": "LOOKUP_ID",
"external_id": "crm-contact-123",
"status": "completed",
"result": {
"recommendation": "send_ready",
"confidence": 88,
"address": {
"address1": "20 Wenlock Road",
"address2": "",
"address3": "",
"city": "London",
"state": "",
"postal_code": "N1 7GU",
"country": "GB"
},
"address_type": "hq_or_office",
"reason_codes": ["company_address_and_person_company_validated"],
"summary": "High confidence business address and person/company match."
},
"created_at": "2026-11-05T10:00:00.000Z",
"updated_at": "2026-11-05T10:01:12.000Z",
"outcome": "ready",
"input": {
"linkedin_url": "https://www.linkedin.com/in/jane-doe",
"full_name": null,
"company_name": null,
"company_domain": "acme.com",
"email": null,
"location": null
}
}
]
Fields
| Field | Type | Description |
|---|---|---|
outcome | string | ready, needs_review, not_found or in_progress. |
input | object | The inputs you sent, so you can tell lookups apart. Missing inputs are null. |
outcome groups result.recommendation:
| Outcome | Recommendations |
|---|---|
ready | send_ready |
needs_review | usable_with_caveats, manual_review |
not_found | do_not_send, or a failed lookup |
in_progress | The lookup is queued or running. |
Status codes
| Status | Meaning |
|---|---|
200 | Lookups returned. |
401 | Missing, malformed, invalid, or unauthorized API key. |
403 | Address Finder is not enabled for your team. |
502 | Address Finder is temporarily unavailable. Retry later. |