Reveal Company
Unlock the full profile for a company. Each reveal deducts the configured reveal cost for the authenticated account and is permanent for your account.
Cost and Idempotency
Every reveal uses the configured reveal cost for the authenticated account. Credits are deducted atomically - if the reveal fails, credits are not deducted.
Revealing a company you have already revealed returns the full data at no cost. The response includes credits_spent: 0 and already_revealed: true.
Success Response
{
"data": {
"id": "cmp_01hxyz123abc",
"name": "Nexus Hotel Group",
"domain": "nexushotelgroup.com",
"website_url": "https://nexushotelgroup.com",
"linkedin_url": "https://linkedin.com/company/nexus-hotel-group",
"industry": "Hospitality & Travel",
"employee_range": "51-200",
"revenue_range": "$10M-$50M",
"country": "US",
"city": "Austin",
"state": "TX",
"address": "1200 Congress Ave, Austin, TX 78701",
"founded_year": 2012,
"company_type": "private",
"technologies": ["..."],
"contacts": [
{
"id": "con_01hxyz456def",
"first_name": "Sarah",
"last_name": "Mitchell",
"title": "VP of Technology",
"department": "Technology",
"email": "s.mitchell@nexushotelgroup.com",
"phone": "+1 (512) 555-0192",
"linkedin_url": "https://linkedin.com/in/sarahmitchell",
"seniority": "VP",
"is_decision_maker": true
}
]
},
"credits_spent": 1,
"new_balance": 199,
"already_revealed": false
}Error Responses
{
"error": "insufficient_credits",
"message": "You need 1 credit but only have 0. Top up at app.primodato.com/billing/topup",
"balance": 0,
"required": 1,
"topup_url": "https://app.primodato.com/billing/topup"
}