Records

Paginated table of the generated emails for a job.

Endpoint

Method: GET Path: /email-generation/jobs/{job_id}/records/ Full URL: https://backend.ecoreservice.com/api/v1/email-generation/jobs/{job_id}/records/ Auth: Authorization: Bearer <JWT>

Query Parameters

Param	Values	Purpose
status	Valid, No Email, Error, All	Filter by record status
generated_by	a finder stage (see below) or All	Filter by which finder produced the email
page	integer ≥ 1	Page number. Default 1.
page_size	integer	Items per page. Default 100.

Per-record Shape

{
  "id": 1,
  "ec_id": null,
  "first_name": "Jane",
  "last_name": "Doe",
  "company_domain": "acme.com",
  "matched_company_domain": null,
  "generated_email": "jane.doe@acme.com",
  "status": "Valid",
  "generated_by": "Primary Finder",
  "validated_by": "Primary",
  "processed_at": "…"
}

Field	Type	Description
id	integer	Record id
ec_id	string | null	Your identifier (preserved from the ec_id column if present)
first_name / last_name	string	The contact
company_domain	string	Domain used to find the email
matched_company_domain	string | null	Alternate matched domain, when supplied
generated_email	string | null	The found email (null when No Email)
status	string	See Status Values
generated_by	string | null	Which eCore finder stage produced the email — see below
validated_by	string | null	Which validation stage confirmed the email — follows the Email Validation cascade
processed_at	datetime | null	When the record received its final status

Status Values

Value	Meaning
Pending	Not processed yet
Valid	Email found and confirmed
No Email	No email could be found (refunded)
Error	Processing error for this record

generated_by Values

generated_by reflects which stage of eCore's email-finding cascade produced the address:

Value	Notes
Primary Finder	First-pass finder
Primary Finder (Matched)	First-pass finder, using the matched domain
Secondary Finder (Client)	Second-pass finder, client domain
Secondary Finder (Matched)	Second-pass finder, matched domain

See Error Codes for the full list.