Properties
Get bulk enrichment job status
Authorization
Path parameters
jobIdstringrequiredJob ID from POST /v1/properties/enrich-bulk
Responses
200objectJob status (resultsUrl re-signed if completed)Show attributesHide attributes
billingStatusenumOutcome of the job's single finalize debit, taken before the results are released: charged, capped (member balance / spend cap / daily cap declined it — the job fails insufficient_credits), billing_error (the debit could not be made — the job fails billing_unavailable), or none (nothing matched). Absent until billing has run, and on older rows.
chargedcappedbilling_errornonechargedCountintegerrequiredIntended charge — matched rows tallied during the run. NOT necessarily what was billed; read creditsCharged for the actual debit and billingStatus for why they differ.
completedAtstringcreditsChargedintegerCredits ACTUALLY debited (0 when the finalize debit was rejected/failed). Absent only on rows written before the field existed, where enrichment billed 1 credit per match and chargedCount was the credit amount.
downloadUrlstringStable, shareable download link for the completed results. Forces a file download (with a friendly filename) and stays valid for 7 days after completion. Present once status is completed. This is the link to hand to a user or send by email.
errorstringWhy the job failed. insufficient_credits = the charge was declined (balance, spend cap or daily cap), no results released. billing_unavailable = the charge could not be made, no results released — retry.
failedintegerrequiredfromCacheintegerrequiredjobIdstringrequiredresultsUrlstringDirect download URL for the completed results. Long-lived per request but changes on each poll; prefer downloadUrl for a stable link to share.
startedAtstringstatusenumrequiredqueuedrunningcompletedfailedcancelledsucceededintegerrequiredtotalintegerrequired401objectAuthentication required403objectCaller does not own this job404objectJob not found (or expired past 30d TTL)