Endpoints
Ungrouped Endpoints 1
What is the Company Enrichment API?
Get stored company profiles by domain or corporate email, including firmographics, contacts, technologies and funding when available. Missing profiles are free.
Company Enrichment API is available on the JoJ API marketplace. Subscribe with a single JoJ API key, call it through one gateway, and pay from one wallet — no separate account or contract with the provider.
Company Enrichment API endpoints
- POST
/enrichEnrich Company
Retrieve a saved company profile by domain or corporate email. Send exactly one JSON field: domain or email. Email input uses its domain to identify the company; it does not identify a person or verify mailbox deliverability. The response is synchronous and does not start an enrichment job. ENRICHED costs $0.02. NOT_FOUND is free. FREE_EMAIL_PROVIDER, DISPOSABLE, invalid_domain and invalid_email are billable. Repeated billable requests are charged again. Authentication, structural validation, rate-limit and server errors are free. Limit: 30 requests per minute per buyer, including repeats and no-match results. Additional input fields are not supported. Response examples are illustrative.
Frequently asked questions about Company Enrichment API
Which enrichment requests are billable?
A request costs $0.02 when it returns ENRICHED, FREE_EMAIL_PROVIDER or DISPOSABLE, or HTTP 422 with error.reason: invalid_domain or invalid_email. Repeats are charged again. NOT_FOUND is free. Authentication failures, rate-limit rejections, malformed JSON, missing or conflicting fields, additional fields, and server or provider failures are free.
What does NOT_FOUND mean, and will enrichment start later?
NOT_FOUND means no ready company profile is available in the database. The synchronous response is HTTP 400 with success: false and data: null, and it is free. The request does not start an enrichment job or require polling. It does not prove that the company does not exist.
Should I send a domain or an email address?
Send exactly one JSON field: domain with a bare company domain, or email with a corporate email address. For email input, only the domain is used to find the company. The API does not identify the person or verify mailbox deliverability. Sending both fields or additional fields returns HTTP 422.