REST API v1

API Documentation

Integrate RevCrest into your existing tools and workflows. Full REST API with webhooks support.

Authentication

Use Bearer token authentication. Generate API keys from your dashboard under Settings > API Keys.

Rate Limits

Starter: 60 req/min. Pro+: 300 req/min. Enterprise: 1000 req/min. Rate limit headers included in every response.

Webhooks

Real-time event notifications with HMAC-SHA256 signature verification. Retry on failure with exponential backoff.

Authentication

All API requests require a Bearer token in the Authorization header. Generate your API key from the dashboard.

bash
# Include your API key in every request
curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://api.revcrest.net/v1/leads

Endpoints

List all leads with pagination and filtering

Parameters

pagenumberPage number (default: 1)
limitnumberResults per page (max: 100)
industrystringFilter by industry
score_minnumberMinimum quality score (0-100)
statusstringFilter by status (new, enriched, contacted)

Example Request

bash
curl -X GET "https://api.revcrest.net/v1/leads?page=1&limit=20&score_min=60" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Example Response

json
{
  "data": [
    {
      "id": 1234,
      "companyName": "Acme Corp",
      "contactName": "John Smith",
      "email": "[email protected]",
      "phone": "+1-555-0123",
      "industry": "Technology",
      "leadScore": 85,
      "qualityGrade": "ideal",
      "status": "enriched",
      "createdAt": "2026-01-15T10:30:00Z"
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 156 }
}

Webhook Events

EventDescriptionPayload
lead.createdNew lead discoveredLead object
lead.enrichedLead enrichment completedLead + enrichment data
lead.scoredLead score updatedLead ID + new score
pipeline.stageChangedDeal moved to new stagePipeline entry + old/new stage
deal.wonDeal marked as wonPipeline entry + deal value
deal.lostDeal marked as lostPipeline entry + loss reason
outreach.generatedOutreach email generatedEmail details + lead ID

SDKs Coming Soon

Official SDKs for Python, Node.js, and Go are in development. In the meantime, use the REST API directly.