Skip to main content
GET
/
v1
/
company-reveal
Company Reveal Finder
curl --request GET \
  --url https://api.waterfall.io/v1/company-reveal \
  --header 'x-api-key: <api-key>'
{
  "status": "SUCCEEDED",
  "start_date": "2026-03-07T10:00:00.000000+00:00",
  "stop_date": "2026-03-07T10:00:00.300000+00:00",
  "input": {
    "task": {
      "ip": "8.8.8.8",
      "webhook_url": null,
      "custom_fields": {},
      "job_id": "b7e4648f-4f15-4f2f-9d09-7af635ce6c24",
      "context_id": "b7e4648f-4f15-4f2f-9d09-7af635ce6c24"
    }
  },
  "output": {
    "ip": "8.8.8.8",
    "type": "company",
    "confidence_score": "high",
    "ip_geo": {
      "city": "San Francisco",
      "state": "California",
      "country": "United States"
    },
    "company": {
      "id": "54fa90d8-7ba7-4b6d-b5ec-82ee3e184166",
      "domain": "stripe.com",
      "name": "Stripe",
      "website": "stripe.com",
      "linkedin_id": "stripe",
      "description": "Stripe is a financial infrastructure platform for businesses.",
      "logo_url": "https://logo.clearbit.com/stripe.com",
      "size": "5001-10000",
      "employees_count": 8000,
      "industry": "Financial Services",
      "type": "Privately Held",
      "founded": 2010,
      "address": "354 Oyster Point Blvd, South San Francisco, California 94080, US",
      "country": "United States",
      "linkedin_url": "https://www.linkedin.com/company/stripe/",
      "linkedin_followers": 1500000,
      "crunchbase_url": "https://www.crunchbase.com/organization/stripe",
      "funding_details": {
        "total_funding_rounds": 0,
        "total_funding_usd": 0,
        "funding_rounds": []
      },
      "recent_job_posting_count": 0,
      "technologies": []
    }
  }
}
Use the job_id returned by Company Reveal Launcher to retrieve a persisted result.
This endpoint is in Beta — not recommended for critical production workloads. API behavior may change.

​
When to use this

Company Reveal returns the result synchronously in the Launcher response — you typically don’t need to call this endpoint. Use it only if you need to look up a past job by job_id.

​
Job states

StatusMeaning
SUCCEEDEDJob completed. Output is in the output field.
RUNNINGJob is still processing.

​
Endpoint details

MetricValue
FlowSync launcher with persisted job
Required inputjob_id query parameter
Typical usageLookup only — result is already in the Launcher response

Authorizations

​
x-api-key
string
header
required

To access the API, provide your API key in x-api-key.

Query Parameters

​
job_id
string<uuid>
required

The unique job_id you want to query. This value is returned by the corresponding launcher endpoint.

A UUID.

Example:

"7d44db58-5de3-4e92-a2fb-8325d12c2e8b"

Response

Company Reveal job state and output returned successfully.

Company Reveal response with synchronous job envelope and output.

​
status
enum<string>
required

The status of the job.

Available options:
RUNNING,
SUCCEEDED,
FAILED,
TIMED_OUT,
ABORTED
Example:

"RUNNING"

​
start_date
string<date-time>
required

A date time in ISO 8601 format.

Example:

"2025-02-05T15:46:35.771751+00:00"

​
input
object
required
​
stop_date
string<date-time>

A date time in ISO 8601 format.

Example:

"2025-02-05T15:46:35.771751+00:00"

​
output
object

Company Reveal output payload.