Skip to main content

API keys and developer access

L
Written by Levon Adamyan
Updated this week

Cleanlist provides a public API for programmatic access to the platform.

Plan requirement: API access is available on Pro and higher plans.

Generating an API key

  1. Click your profile avatar in the top right.

  2. Select API Keys.

  3. Click Create New Key.

  4. Copy your key immediately - it will not be shown again.

API keys start with the clapi_ prefix. You can have up to 10 active keys per organization.

Using API keys

Include your API key in the Authorization header of your requests:

Authorization: Bearer clapi_your_key

The API base URL is https://api.cleanlist.ai/api/v1/public

Available endpoints

  • GET /auth/validate-key - Verify your API key is valid

  • GET /credits/balance - Check your organization's credit balance

  • POST /enrich/bulk - Submit up to 250 contacts for enrichment

  • GET /enrich/status - Poll enrichment workflow status

  • GET /webhooks/deliveries - View webhook delivery logs

Security

  • Never share your API key or commit it to code repositories.

  • You can revoke a key at any time from the API Keys page.

  • Each key has the same permissions as your user account.

For the complete API reference, see docs.cleanlist.ai.

Did this answer your question?