Introduction

​

Authentication

All API requests require authentication using an API key. Include your API key in the request header:

x-api-key: YOUR_API_KEY

​

Base URL

All API requests should be made to:

https://api.goextrovert.com/client/v1

​

Available Endpoints

The Extrovert API provides endpoints for managing prospects in your campaigns:

• Get Prospects with Statistics - Retrieve prospects with detailed engagement statistics
• Add Prospect to List - Add a prospect to a specific campaign and list
• Remove Prospect from Campaign - Remove a prospect from a specific campaign
• Remove Prospect from Workspace - Remove a prospect from entire workspace

​

Response Format

All API responses follow the same JSON structure:

{
  "status": "success" | "error",
  "data": null | object,
  "message": "Response message",
  "statusCode": 200 | 201 | 400 | 401
}

For the GET prospects endpoint, the data field contains a list array with prospect details and statistics.

​

Error Handling

The API uses standard HTTP response codes:

• 200 - OK (Success for GET requests)
• 201 - Created (Success for POST/DELETE requests)
• 400 - Bad Request (validation errors, business logic errors)
• 401 - Unauthorized (invalid or missing API key)

​

Getting Started

1. Obtain your API key from the dashboard
2. Use the API playground to test endpoints
3. Integrate the API into your application