Skip to main content
GET
/
sourcing
/
enrich
/
{id}
/
results
Get enrichment results
curl --request GET \
  --url https://api.instaview.sk/sourcing/enrich/{id}/results \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "requestId": "enr_550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "message": "Enrichment is in progress. Please poll again in a few seconds.",
  "createdAt": "2025-01-01T00:00:00.000Z",
  "completedAt": "2025-01-01T00:00:05.000Z",
  "enrichedCount": 3,
  "failureCount": 1,
  "creditsConsumed": 3,
  "data": [
    {
      "profileId": "a1b2c3d4e5f6",
      "success": true,
      "candidate": {
        "profileId": "a1b2c3d4e5f6",
        "name": "Jane Smith",
        "linkedinUrl": "https://www.linkedin.com/in/janesmith",
        "matchScore": 87,
        "rationale": "Strong fintech background with Node.js expertise.",
        "skills": [
          "Node.js",
          "TypeScript",
          "PostgreSQL"
        ],
        "headline": "Senior Software Engineer at Stripe",
        "location": "San Francisco, CA",
        "currentCompany": "Stripe",
        "currentRole": "Senior Software Engineer",
        "aiFitPoints": [
          "5+ years Node.js",
          "FinTech background"
        ],
        "aiRedFlags": [
          "No public cloud experience"
        ],
        "aiDetailedRationale": [
          {
            "title": "Senior Developer",
            "company": "Tech Corp",
            "duration": "2 years",
            "relevanceExplanation": "Led a team of 5 developers using Python/Django."
          }
        ],
        "detailedExperience": [
          {
            "role": "Staff ML Infrastructure Engineer",
            "company": "TechCorp",
            "duration": "2023 - Present",
            "highlights": [
              "Architected low-latency prompt caching server decreasing LLM inference cost by 42%."
            ]
          }
        ],
        "emails": [
          "jane.smith@example.com"
        ]
      },
      "errorCode": "PROFILE_NOT_FOUND",
      "errorMessage": "Profile not found in any sourcing session for this company."
    }
  ],
  "errorCode": "INTERNAL_ERROR",
  "errorMessage": "An unexpected error occurred during enrichment."
}

Documentation Index

Fetch the complete documentation index at: https://docs.instaview.sk/llms.txt

Use this file to discover all available pages before exploring further.

Returns the current state of an enrichment run. While the run is in progress the response is 202 Accepted with status: "processing". Once finished it becomes 200 OK with per-profile results.

​
Overview

Use this endpoint to poll for enrichment results when you do not have a webhook configured. The id path parameter is the requestId returned by POST /sourcing/enrich.

​
Response Examples

​
Still Processing (202 Accepted)

{
  "success": true,
  "requestId": "enr_550e8400-e29b-41d4-a716-446655440001",
  "status": "processing",
  "message": "Enrichment is in progress. Please poll again in a few seconds.",
  "createdAt": "2026-05-20T13:21:00.000Z"
}

​
Completed (200 OK)

{
  "success": true,
  "requestId": "enr_550e8400-e29b-41d4-a716-446655440001",
  "status": "completed",
  "enrichedCount": 2,
  "failureCount": 0,
  "creditsConsumed": 2,
  "createdAt": "2026-05-20T13:21:00.000Z",
  "completedAt": "2026-05-20T13:21:22.000Z",
  "data": [
    {
      "profileId": "prof_a9238f82-a723",
      "success": true,
      "candidate": {
        "profileId": "prof_a9238f82-a723",
        "name": "Jane Doe",
        "linkedinUrl": "https://www.linkedin.com/in/janedoe-ml",
        "emails": ["jane.doe@techcorp.com", "jdoe.infra@gmail.com"],
        "headline": "Staff ML Infrastructure Engineer at TechCorp",
        "currentCompany": "TechCorp",
        "location": "Seattle, WA, USA",
        "matchScore": 96,
        "skills": ["vLLM", "PyTorch", "Kubernetes", "LLMs", "Vector Databases"],
        "detailedExperience": [
          {
            "role": "Staff ML Infrastructure Engineer",
            "company": "TechCorp",
            "duration": "2023 - Present",
            "highlights": [
              "Architected low-latency prompt caching server decreasing LLM inference cost by 42%.",
              "Deployed production-level multi-agent workflow system servicing 2M DAU."
            ]
          }
        ]
      }
    },
    {
      "profileId": "prof_e8321c12-b912",
      "success": true,
      "candidate": {
        "profileId": "prof_e8321c12-b912",
        "name": "Alex Smith",
        "linkedinUrl": "https://www.linkedin.com/in/alexsmith-ai",
        "emails": ["alex.smith@automateglobal.com"],
        "headline": "Senior AI Systems Engineer at AutomateGlobal",
        "currentCompany": "AutomateGlobal",
        "location": "Austin, TX, USA",
        "matchScore": 88,
        "skills": ["LangChain", "Python", "LlamaIndex", "FastAPI"]
      }
    }
  ]
}

​
Completed with Partial Failure (200 OK)

{
  "success": true,
  "requestId": "enr_550e8400-e29b-41d4-a716-446655440001",
  "status": "completed",
  "enrichedCount": 1,
  "failureCount": 1,
  "creditsConsumed": 1,
  "createdAt": "2026-05-20T13:21:00.000Z",
  "completedAt": "2026-05-20T13:21:22.000Z",
  "data": [
    {
      "profileId": "prof_a9238f82-a723",
      "success": true,
      "candidate": { "..." : "..." }
    },
    {
      "profileId": "prof_unknown-xyz",
      "success": false,
      "errorCode": "PROFILE_NOT_FOUND",
      "errorMessage": "Profile not found in any sourcing session for this company."
    }
  ]
}

​
Failed (200 OK with status: "failed")

{
  "success": true,
  "requestId": "enr_550e8400-e29b-41d4-a716-446655440001",
  "status": "failed",
  "errorCode": "INTERNAL_ERROR",
  "errorMessage": "An unexpected error occurred during enrichment.",
  "createdAt": "2026-05-20T13:21:00.000Z",
  "completedAt": "2026-05-20T13:21:05.000Z"
}

​
Partial Success vs. Run Failure

A status: "completed" response can include individual per-profile failures — those profiles have success: false in the data array and are not billed. A status: "failed" response indicates the entire run encountered an unrecoverable error before any profile could be processed.

Authorizations

​
Authorization
string
header
required

API key for authentication using Bearer scheme

Path Parameters

​
id
string
required

The requestId returned by POST /sourcing/enrich (e.g. enr_550e8400-…).

Response

Enrichment results (completed or failed)

​
success
boolean
required

Whether the request succeeded.

Example:

true

​
requestId
string
required

The enrichment run request ID.

Example:

"enr_550e8400-e29b-41d4-a716-446655440000"

​
status
enum<string>
required

Current status of the enrichment run.

Available options:
processing,
completed,
failed
Example:

"processing"

​
message
string

Human-readable message. Present while the run is still processing.

Example:

"Enrichment is in progress. Please poll again in a few seconds."

​
createdAt
string

ISO 8601 timestamp when the run was created.

Example:

"2025-01-01T00:00:00.000Z"

​
completedAt
string

ISO 8601 timestamp when the run completed or failed.

Example:

"2025-01-01T00:00:05.000Z"

​
enrichedCount
integer

Number of profiles successfully enriched.

Example:

3

​
failureCount
integer

Number of profiles that failed enrichment.

Example:

1

​
creditsConsumed
integer

Credits consumed by this enrichment run.

Example:

3

​
data
object[]

Per-profile enrichment results. Present when status = 'completed'.

​
errorCode
string

Machine-readable error code when status = 'failed'.

Example:

"INTERNAL_ERROR"

​
errorMessage
string

Human-readable error message when status = 'failed'.

Example:

"An unexpected error occurred during enrichment."