Get an enrichment request
Returns an enrichment request with the status and result of each item. Poll it until status is completed, partially_completed or failed; while it is pending or in_progress, wait before you poll again. Every call counts toward your rate limit.
Items are listed in the order you submitted them, one per distinct input. A person's result includes their current company.
Enrichment has a 24-hour deadline: an item still pending 24 hours after the request was created is settled the next time you read the request, as completed if Knock has data for it and failed otherwise. If Knock cannot check at that moment, the item stays pending until a later read.
ApiKeyAuthx-api-key<token>Your Knock API key. Ask your Knock account team for one: a key with the Enrichment API role for enrichment, or the Viewer role for chats and meetings.
enrichRequestId*stringThe enrichRequestId you received when you submitted the request.
uuidThe enrichment request. Its type tells you whether the items are people or companies.
application/json- response
A people enrichment request and its items.
enrichRequestId*stringID of the enrichment request.
uuidtype*"people"What the request enriches.
"people"status*stringStatus of the request.
"pending""in_progress""completed""partially_completed""failed"createdAt*stringWhen the request was created (ISO 8601, UTC).
date-timeitems*array<>One item per distinct email, in the order you submitted them.
curl -X GET 'https://app.knock-ai.com/v1/enrichment-requests/7d0f4f1e-2c3b-4a8e-9a51-0e6f3b8c2d14' \ -H 'x-api-key: <YOUR_API_KEY>'{ "enrichRequestId": "7d0f4f1e-2c3b-4a8e-9a51-0e6f3b8c2d14", "type": "people", "status": "in_progress", "createdAt": "2026-10-20T09:30:00.000Z", "items": [ { "input": "jane@acme.com", "status": "completed", "result": { "firstName": "Jane", "lastName": "Doe", "title": "VP Sales", "seniority": "VP", "profession": "Sales", "linkedinUrl": "https://www.linkedin.com/in/jane-doe", "location": "Austin, Texas, United States", "photoUrl": "https://media.example.com/jane-doe.jpg", "currentPositionStartDate": "2024-03", "company": { "name": "Acme", "domain": "acme.com", "logoUrl": "https://logo.example.com/acme.png", "description": "Acme builds scheduling software for revenue teams.", "industry": "COMPUTER_SOFTWARE", "size": "101-200", "employees": "120", "foundedDate": "2015", "totalFunding": "$22M", "lastFunding": "series_a", "annualRevenue": "$10m-$25m", "ownership": "Private", "headquarters": "New York, NY", "country": "US", "region": "North America", "state": "New York", "competitors": "Globex, Initech", "techStack": [ { "name": "Salesforce", "category": "CRM" } ], "teamSize": [ { "department": "Sales", "headcount": 40 } ], "fundingRounds": [ { "type": "series_a", "amountMillions": 22, "currency": "USD", "date": "2024-03-01", "investors": [ "Example Ventures" ] } ], "accountIntel": { "targetPersona": [ "Sales Director" ], "segments": [ "Enterprise", "SMBs" ], "verticals": [ "Software" ], "spaces": [ "Sales" ], "productTypes": [ "Inbound scheduling & routing" ], "salesMotions": [ "Sales-Led" ] }, "decisionMakers": [ { "name": "Bob Smith", "title": "CRO", "linkedinUrl": "https://www.linkedin.com/in/bob-smith", "matchedRole": "Sales leader" } ] } } } ]}