Get estimation status/results

GET

/count-estimate/{batchId}

Access required — This endpoint is available to approved accounts only. Contact us to request access.

Check the status of a count estimation job and retrieve results when complete.

Cost: Free — polling never costs credits.

Refunds: If the job fails within 7 days, the 100 credits are refunded automatically on the next status check.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200OK

application/json

Estimation status and results

Body

🟠401Unauthorized

🟠404Not Found

🟠429Too Many Requests

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://dev.enrich.so/api/v3/count-estimate/665b2a3f4c5d6e0013fgh002' \
--header 'x-api-key: <api-key>'

Response Example

200 - Success

{
    "success": true,
    "data": {
        "batchId": "665b2a3f4c5d6e0013fgh002",
        "status": "completed",
        "companyUrl": "https://linkedin.com/company/stripe",
        "message": "Count estimation complete. Found 8542 followers matching your criteria.",
        "createdAt": "2025-06-03T14:30:00.000Z",
        "completedAt": "2025-06-03T14:31:15.000Z",
        "data": {
            "totalCount": 8542,
            "functionBreakdown": [
                {
                    "functionName": "Engineering",
                    "functionId": "8",
                    "count": 3200,
                    "percentage": 37.5
                },
                {
                    "functionName": "Sales",
                    "functionId": "25",
                    "count": 1850,
                    "percentage": 21.7
                }
            ],
            "filtersApplied": {
                "departments": ["Engineering", "Sales"]
            }
        }
    },
    "meta": {
        "requestId": "664f2b3c9a1e4d0012abcdef"
    }
}

Modified at 2026-02-07 21:20:46

Start count estimation

Start company follower scrape