Skip to main content

Result

Fetch a job's results as paginated JSON or a CSV export.

Endpoint

Method: GET Path: /career-monitor/result/{job_id}/ Full URL: https://backend.ecoreservice.com/api/v1/career-monitor/result/{job_id}/ Auth: Authorization: Token YOUR_API_TOKEN (or Bearer) — see Authentication

Query Parameters

ParamTypeDescription
report_typestringjson (default) or csv
pageintegerPage number. Default 1. JSON only.
page_sizeintegerRecords per page. Default 100, max 1000. JSON only.

Example Request

# JSON
curl "https://backend.ecoreservice.com/api/v1/career-monitor/result/123/?report_type=json&page=1&page_size=100" \
-H "Authorization: Token YOUR_API_TOKEN"

# CSV
curl "https://backend.ecoreservice.com/api/v1/career-monitor/result/123/?report_type=csv" \
-H "Authorization: Token YOUR_API_TOKEN" -o results.csv

Successful Response — 200 OK (JSON)

{
"job_id": 123,
"job_status": "Completed",
"total_records": 2,
"page": 1,
"page_size": 100,
"data": [
{
"ec_id": "1001",
"first_name": "Jane",
"last_name": "Doe",
"current_title": "VP Sales",
"contact_location": "San Francisco, CA",
"original_company_name": "Acme Corp",
"matched_company_name": "Acme Corporation",
"company_website": "acme.com",
"status": "Still in the company"
}
]
}

Passing report_type=csv streams a CSV file instead (use a download client / curl -o).

Record Status Values

Each result row carries a status:

ValueMeaning
Still in the companyContact is still employed at the provided company
Left the companyContact has left / changed jobs
UncertainVerification inconclusive
Unable to matchCould not match the contact to a company
Broken LIMissing or invalid LinkedIn URL
ErrorProcessing error for this record
Pending / ProcessingNot finished yet

Results can be polled while the job is still Processing; rows that aren't finished yet show Pending / Processing in their status.

Error Responses

HTTPWhenBody
400Job not found / not owned by this account{ "error": "..." }
401Missing or invalid token{ "detail": "Authentication credentials were not provided." }
403Test-mode token used{ "error": "Test tokens cannot be used for credit-consuming operations. Use a live API key or JWT." }

See Error Codes for the full list.