API Reference · integration

Enrich Segment events via API

Enrich Segment events inline with firmographics before they hit your warehouse.

Endpoint

POST https://api.cleanlist.ai/v1/enrich/segment_event

Request

POST https://api.cleanlist.ai/v1/enrich/segment_event
Authorization: Bearer clnl_live_...
Content-Type: application/json

{
  "email": "jane@acme.com"
}

Response

{
  "id": "ev_abc123",
  "segment_event": {
    "anonymous_id": "<anonymous_id>",
    "email": "<email>",
    "enriched_traits": "<enriched_traits>"
  },
  "meta": {
    "credits_used": 11,
    "providers_queried": 15
  }
}

Field reference

Field	Type	Description
anonymous_id	string	—
email	string	—
enriched_traits	string	—

Code samples

curl

curl -X POST https://api.cleanlist.ai/v1/enrich/segment_event \
  -H "Authorization: Bearer $CLEANLIST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "jane@acme.com"}'

Node.js

import Cleanlist from "cleanlist";

const client = new Cleanlist(process.env.CLEANLIST_API_KEY);

const result = await client.enrich.segment_event({
  email: "jane@acme.com",
});
console.log(result.segment_event.title);

Python

from cleanlist import Cleanlist

client = Cleanlist(api_key=os.environ["CLEANLIST_API_KEY"])

result = client.enrich.segment_event(email="jane@acme.com")
print(result["segment_event"]["title"])

Pricing

Credit-based, no per-seat fees. This endpoint uses the standard enrichment rate:

Email only: 1 credit per enriched segment_event.
Email + phone: 11 credits per enriched segment_event.
Free tier: 30 credits/mo. See all pricing.

Next steps

Full REST reference: /product/api.
Related glossary: data enrichment, waterfall enrichment.
Ready to ship? Start free with 30 credits.