Scribeless
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

FieldTypeDescription
outcomestringready, needs_review, not_found or in_progress.
inputobjectThe inputs you sent, so you can tell lookups apart. Missing inputs are null.

outcome groups result.recommendation:

OutcomeRecommendations
readysend_ready
needs_reviewusable_with_caveats, manual_review
not_founddo_not_send, or a failed lookup
in_progressThe lookup is queued or running.

Status codes

StatusMeaning
200Lookups returned.
401Missing, malformed, invalid, or unauthorized API key.
403Address Finder is not enabled for your team.
502Address Finder is temporarily unavailable. Retry later.
Copyright © 2026