logo
OpenapiOutbound

List outbound leads

API Docs with browser client
GET
/outbound/runs/{runId}/leads

List discovered leads for a run in ranked order with public rationale, contacts, and generated outreach drafts when available. The ranking is represented by response order; internal score and rank fields are intentionally not exposed.

Authorization

x-api-key<token>

In: header

Path Parameters

runId*string
Formatuuid

Query Parameters

cursor?string
Length1 <= length <= 2048
limit?integer
Default20
Range1 <= value <= 100

Header Parameters

x-namefi-eip7702-account?string

Optional delegated account address to authenticate as when the signer is an approved signer. Preferred header name.

x-namefi-eip1271-account?string

Legacy alias for x-namefi-erc1271-account. When multiple delegated account headers are present, x-namefi-eip7702-account takes precedence, then x-namefi-erc1271-account.

x-namefi-erc1271-account?string

Optional delegated account address to authenticate as when the signer is an approved signer. Preferred ERC-1271 header name.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.namefi.dev/v-next/outbound/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08/leads"
{
  "items": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "businessDomain": "string",
      "buyerSummary": "string",
      "contactCount": 9007199254740991,
      "draftCount": 9007199254740991,
      "rationale": "string",
      "content": "string",
      "contacts": [
        {
          "email": "string",
          "name": "string",
          "title": "string",
          "sourceUrl": "string",
          "context": "string"
        }
      ],
      "drafts": [
        {
          "contactEmail": "string",
          "subject": "string",
          "fullEmail": "string"
        }
      ]
    }
  ],
  "nextCursor": "string"
}
{
  "defined": true,
  "code": "BAD_REQUEST",
  "status": 400,
  "message": "Bad Request",
  "data": null
}
{
  "defined": true,
  "code": "UNAUTHORIZED",
  "status": 401,
  "message": "Unauthorized",
  "data": null
}
{
  "defined": true,
  "code": "PAYMENT_REQUIRED",
  "status": 402,
  "message": "Payment Required",
  "data": null
}
{
  "defined": true,
  "code": "FORBIDDEN",
  "status": 403,
  "message": "Forbidden",
  "data": null
}
{
  "defined": true,
  "code": "NOT_FOUND",
  "status": 404,
  "message": "Not Found",
  "data": null
}
{
  "defined": true,
  "code": "NOT_ACCEPTABLE",
  "status": 406,
  "message": "Not Acceptable",
  "data": null
}
{
  "defined": true,
  "code": "TIMEOUT",
  "status": 408,
  "message": "Request Timeout",
  "data": null
}
{
  "defined": true,
  "code": "CONFLICT",
  "status": 409,
  "message": "Conflict",
  "data": null
}
{
  "defined": true,
  "code": "PRECONDITION_FAILED",
  "status": 412,
  "message": "Precondition Failed",
  "data": null
}
{
  "defined": true,
  "code": "TOO_MANY_REQUESTS",
  "status": 429,
  "message": "Too Many Requests",
  "data": null
}
{
  "defined": true,
  "code": "INTERNAL_SERVER_ERROR",
  "status": 500,
  "message": "Internal Server Error",
  "data": null
}

Get outbound run status GET

Get the current status and aggregate counts for one outbound lead-finding run. Poll using pollAfterSeconds while status is QUEUED or RUNNING.

List outbound lead-finding runs GET

List the authenticated user's outbound lead-finding runs, newest first. Use this to resume recent work before starting a new run.