Skip to main content

Account by ID API

Get detailed information about a specific account including metadata, scoring, and recent activity. Useful for displaying account detail pages or syncing account data with external systems.

GET /accounts/{id}​

Returns comprehensive data for a single account.

Request​

ParameterTypeRequiredDescription
idstringYesAccount ID or domain

Example​

curl -X GET "https://api.leadvibe.com/accounts/acct_abc123" \
  -H "Authorization: Bearer <token>"

Response​

200 OK

{
  "account_id": "acct_abc123",
  "domain": "acme.com",
  "name": "Acme Corporation",
  "account_score": 85,
  "account_level": "Target",
  "total_leads": 12,
  "engagement_score": 245,
  "last_activity_at": "2026-01-30T14:23:00Z",
  "surge_active": true,
  "surge_window_start": "2026-01-28T00:00:00Z",
  "surge_event_count": 47,
  "metadata": {
    "company_size": "Enterprise",
    "industry": "Technology",
    "country": "United States",
    "employees": 2500,
    "revenue": 50000000,
    "plan": "Pro",
    "account_status": "Customer"
  },
  "created_at": "2025-11-15T10:00:00Z",
  "updated_at": "2026-01-30T14:23:00Z"
}

Response Fields​

FieldTypeDescription
account_idstringUnique account identifier
domainstringPrimary email domain
namestringAccount name (company name)
account_scoreintegerFirmographic score
account_levelstringAccount tier
total_leadsintegerNumber of associated contacts
engagement_scoreintegerCombined engagement score
last_activity_attimestampMost recent activity
surge_activebooleanWhether currently in surge
surge_window_starttimestampSurge window start (if active)
surge_event_countintegerEvents during surge (if active)
metadataobjectAccount metadata (firmographic attributes)
created_attimestampAccount creation time
updated_attimestampLast update time

Common Errors​

StatusMeaningSolution
401UnauthorizedCheck authentication credentials
404Not FoundAccount does not exist or is not accessible
500Server ErrorContact support if the issue persists

Notes​

  • Account ID can be found in the account list or derived from account_id on leads
  • Account metadata comes from Account Field Mappings
  • Surge data is available when surge detection is enabled for your organization