Our dataPricingContact
Log in

API reference

Milda API

Base URL
https://api.milda.ai
Overview

Credit Usage1

  • GETCredit Usage

Company Search2

  • POSTLookup
  • POSTText Search

Companies7

  • POSTEnrichment
  • POSTStatuses
  • POSTProfiles
  • POSTEvents
  • POSTPlaces Of Performance
  • POSTGrowth Signals
  • POSTCompetitors

People2

  • POSTSearch
  • POSTVerified Email

Trade Data5

  • POSTCandidates
  • POSTAnalytics
  • POSTShipping Records
  • POSTShipment Suppliers
  • POSTShipment Recipients

Patents7

  • POSTSummary
  • POSTCo Applicants
  • POSTInventors
  • POSTTechnology Users
  • POSTTechnology Providers
  • POSTCitations
  • POSTList

Publications5

  • POSTAnalytics
  • POSTAuthors
  • POSTFunders
  • POSTCollaborating Organizations
  • POSTTop Cited Works

Risk Assessment4

  • POSTCandidates
  • POSTFinancials
  • POSTOwnership
  • POSTReport

Companies

1 of 7
POSThttps://api.milda.ai/v1/companies/enrichment

Enrichment

application/json
01

Description

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
  1. Step 1 – Submit a list of companies using company_ids or urls
    → You receive their current status.
  2. Step 2 – Wait 24–48 hours, then use the Get Company Statuses endpoint
    → Check if the statuses have changed (e.g., to ON_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

02

Headers

nameinreqdescription
tokenheaderyesAPI token. Issued per account; check it with GET /v1/credit-usage.
03

Request body

CompanyStatusRequestItem
CompanyStatusRequestItemtypereq3 fields
company_idsstring[]—Array of company ids (up to 1000)
urlsstring[]—Array of company URLs or domain addresses (up to 1000)
emailsstring[]—Array of company emails (up to 1000)
04

Responses

200 Successful Response422 Validation Error
EnrichmentSubmissiontypereq2 fields
+companiesSubmittedCompanyStatusProfile[]yesList of companies included in the enrichment request, along with their submission statuses.
requested_company_idstring | null—Company ID provided in the request, if available.
requested_urlstring | null—Company website URL provided in the request, if available.
requested_emailstring | null—Email address submitted in the request, if available.
company_idstring | null—Resolved or matched unique identifier for the company.
statusCompanyStatus | null—Status of the company, representing the result of processing and matching. Possible values: - 'ON_PLATFORM': The company is found and present on the platform. - 'PROCESSING': The company has been identified and is currently being processed. - 'NOT_PROCESSED': The company has been identified but has not been processed yet. - 'UNAVAILABLE': The company exists but data is unavailable. - 'NOT_FOUND': The company could not be found using the provided inputs. - 'INVALID_INPUT': The provided URL or email was malformed and could not be resolved.
submittedbooleanyesIndicates whether the company was successfully submitted for enrichment.
n_submittedintegeryesTotal number of companies successfully submitted for enrichment.
PreviousText SearchNextStatuses

© 2026 Milda.ai All rights reserved.

  • Privacy policy
  • Terms and Conditions