https://api.milda.ai/v1/companies/enrichmentEnrichment
application/jsonDescription
This endpoint allows you to submit a list of companies for enrichment using either Milda company IDs or company URLs.
Purpose
Milda may not have data for all companies in your database. This endpoint initiates the enrichment process, which usually takes 24–48 hours to complete.
Use this when:
- You want to enrich firmographic and contact data for companies currently marked as NOT_PROCESSED.
- You want to check which submitted companies will eventually become available on the platform.
Enrichment Workflow
- Step 1 – Submit a list of companies using
company_idsorurls
→ You receive their current status. - Step 2 – Wait 24–48 hours, then use the Get Company Statuses endpoint
→ Check if the statuses have changed (e.g., toON_PLATFORM).
Important:
Only companies with NOT_PROCESSED status should be submitted.
Submitting companies with any other status will not change anything.
Statuses Returned
For each company submitted, you may receive:
- ON_PLATFORM – Data enrichment complete. Company data is now available.
- PROCESSING – Data collection in progress (usually completes within 24 hours).
- NOT_PROCESSED – No data previously collected. Submitting starts enrichment and status changes to
PROCESSING. - UNAVAILABLE – Enrichment failed. Common reasons:
- Website inaccessible
- Site blocks data scraping
- NOT_FOUND – Invalid or unrecognized company ID or URL
What to Do After Enrichment
Once a company reaches ON_PLATFORM status, you can:
- Use Text Search to segment your enriched companies
- Use Profiles to access their firmographic profile
- Use People Search and Get Verified Emails for employee and contact data
Credit Usage
- Free – No credits are consumed when submitting companies
- Limit – Up to 50,000 companies (or 50,000 enrichment credits) can be submitted for enrichment
Rate Limit
10 requests per second