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

2 of 7
POSThttps://api.milda.ai/v1/companies/status

Statuses

application/json
01

Description

This endpoint is used to obtain Milda company IDs and their current/live statuses using company IDs, URLs, or emails as input.


Input Options

You can provide one of the following: - Milda company IDs (retrievable via Milda’s search endpoints) - Company URLs (formats supported: https://milda.ai/api or milda.ai) - Emails (must include the company domain, e.g., name@milda.ai)

Purpose

This endpoint helps users determine: - Which companies to submit to the Submit Companies for Enrichment endpoint
- The current processing status of previously submitted companies

If a company has a NOT_PROCESSED status, it is eligible to be submitted for enrichment. Once enriched successfully, the company status becomes ON_PLATFORM.

Status Values Returned
  • ON_PLATFORM – Company is available on Milda’s platform; data can be queried.
  • PROCESSING – Data collection is in progress; typically completed within 24 hours. Final status will be either ON_PLATFORM or UNAVAILABLE.
  • NOT_PROCESSED – No data collected yet. Submitting it via the enrichment endpoint starts processing and changes its status to PROCESSING.
  • UNAVAILABLE – Data collection failed. Often due to:
  • Inaccessible company website
  • Website restrictions (e.g., scraping not allowed)
  • NOT_FOUND – The provided company ID was not recognized. (A URL/email that resolves to a company not yet on the platform returns NOT_PROCESSED, not NOT_FOUND.)
  • INVALID_INPUT – The provided URL or email was malformed and could not be resolved to a company.
Credit Usage
  • Calling this endpoint does not consume credits.
  • Unlimited number of queries allowed.

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
PreviousEnrichmentNextProfiles

© 2026 Milda.ai All rights reserved.

  • Privacy policy
  • Terms and Conditions