Skip to main content

Search Accounts

Search for companies (accounts) across your organization using a variety of filters. Send an empty body to return all results.
company_name
string
Filter by company name (partial match).
industry
string
Filter by industry.
country
string
Filter by country.
employee_size_category
string
Filter by employee size category.
revenue_category
string
Filter by revenue category.
public_company
boolean
Filter by public company status.
page
integer
default:"1"
Page number for pagination.
per_page
integer
default:"50"
Number of items per page.
offset
integer
Offset for pagination.
Permission: accounts:read
curl -X POST "https://api.pipelinegeneration.ai/v1/accounts" \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "industry": "Technology",
    "country": "United States",
    "per_page": 10
  }'
[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Acme Corporation",
    "domain": "acme.com",
    "industry": "Technology",
    "employee_count": 5000,
    "revenue": "$500M - $1B",
    "country": "United States"
  },
  {
    "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
    "name": "GlobalSoft",
    "domain": "globalsoft.io",
    "industry": "Technology",
    "employee_count": 2500,
    "revenue": "$100M - $500M",
    "country": "United States"
  }
]

Get Company

Retrieve detailed information about a specific company by its ID.
company_id
string
required
The unique identifier (UUID) of the company.
Permission: insights:read
curl -X GET "https://api.pipelinegeneration.ai/v1/companies/{company_id}" \
  -H "x-api-key: your_api_key"
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Acme Corporation",
  "domain": "acme.com",
  "industry": "Technology",
  "employee_count": 5000,
  "revenue": "$500M - $1B",
  "country": "United States",
  "description": "Leading provider of enterprise solutions...",
  "logo_url": "https://logo.clearbit.com/acme.com",
  "linkedin_url": "https://linkedin.com/company/acme",
  "website": "https://acme.com"
}

Get Company Profile

Retrieve a customizable company profile with selectable sections. Use the include parameter to request specific sections, or pass full to get everything.
company_id
string
required
The unique identifier (UUID) of the company.
include
string
Comma-separated list of profile sections to include. Use full for all sections.Available sections: overview, key_executives, divisions, geographical_operations, swot_analysis, competitors, industry_insights, strategic_priorities, digital_strategies, risks, goals, insights_scores, events, value_pyramid, three_whys, discovery_questions, how_they_make_money, how_they_lose_money, custom_insights, employee_groups, favourite_technologies_count, territory_custom_scores, content
exclude
string
Comma-separated list of profile sections to exclude. Useful when requesting full but omitting certain sections.
sources
string
Set to true to include source citations alongside profile data.
Permission: insights:read
curl -X GET "https://api.pipelinegeneration.ai/v1/companies/{company_id}/profile?include=overview,swot_analysis,competitors&sources=true" \
  -H "x-api-key: your_api_key"
{
  "company_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Acme Corporation",
  "overview": {
    "summary": "Acme Corporation is a leading enterprise technology provider...",
    "founded": "1995",
    "headquarters": "San Francisco, CA",
    "sources": [
      { "url": "https://acme.com/about", "title": "About Acme" }
    ]
  },
  "swot_analysis": {
    "strengths": ["Market leader in enterprise solutions", "Strong R&D investment"],
    "weaknesses": ["Limited presence in APAC"],
    "opportunities": ["AI integration", "Cloud migration demand"],
    "threats": ["Increasing competition from startups"]
  },
  "competitors": [
    { "name": "TechCorp", "domain": "techcorp.com" },
    { "name": "GlobalSoft", "domain": "globalsoft.io" }
  ]
}

Get Company Content

Retrieve content generated for a company, such as emails, call scripts, and documents.
company_id
string
required
The unique identifier (UUID) of the company.
type
string
Filter by content type. Valid values: email, notes, call_script, document, value_pyramid, three_whys
page
integer
default:"1"
Page number for pagination.
per_page
integer
default:"100"
Number of items per page.
Permission: insights:read
curl -X GET "https://api.pipelinegeneration.ai/v1/companies/{company_id}/content?type=email&page=1&per_page=25" \
  -H "x-api-key: your_api_key"
[
  {
    "id": "cnt_abc123",
    "type": "email",
    "title": "Introduction Email for Acme",
    "body": "Hi {{first_name}},\n\nI noticed Acme recently...",
    "created_at": "2026-03-10T14:30:00Z",
    "updated_at": "2026-03-10T14:30:00Z"
  }
]

Search Company Contacts

Search and filter contacts associated with a specific company. Uses POST to support complex filter combinations in the request body.
company_id
string
required
The unique identifier (UUID) of the company.
page
integer
default:"1"
Page number for pagination.
per_page
integer
default:"25"
Number of items per page.
name
string
Filter contacts by name.
job_title
string
Filter contacts by job title.
location
string
Filter contacts by location.
linkedin_url
string
Filter contacts by LinkedIn URL.
Permission: insights:read
curl -X POST "https://api.pipelinegeneration.ai/v1/companies/{company_id}/contacts" \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "job_title": "VP",
    "page": 1,
    "per_page": 10
  }'
{
  "contacts": [
    {
      "id": "c1d2e3f4-a5b6-7890-cdef-123456789012",
      "first_name": "Jane",
      "last_name": "Smith",
      "job_title": "VP of Engineering",
      "email": "[email protected]",
      "linkedin_url": "https://linkedin.com/in/janesmith",
      "location": "San Francisco, CA"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "total": 42
  }
}

Get Company Technologies

Retrieve the technology stack for a company with optional filtering. Uses POST to support filter parameters in the request body.
company_id
string
required
The unique identifier (UUID) of the company.
category
string
Filter by technology category. Valid categories include: Data, BI and Analytics, Collaboration, Communications, Customer Management, Devops And Development, E-commerce, Finance And Accounting, IT Security, Marketing, Sales, and more.
confidence
string
Filter by detection confidence level.
favourites
boolean
Set to true to only return technologies marked as favourites in your workspace.
query
string
Search query to filter technologies by name.
page
integer
default:"1"
Page number for pagination.
per_page
integer
default:"100"
Number of items per page.
Permission: insights:read
curl -X POST "https://api.pipelinegeneration.ai/v1/companies/{company_id}/technologies" \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "IT Security",
    "favourites": true,
    "per_page": 50
  }'
[
  {
    "name": "Cloudflare",
    "category": "IT Security",
    "confidence": "high",
    "first_detected": "2025-11-15",
    "last_detected": "2026-03-01",
    "is_favourite": true
  },
  {
    "name": "CrowdStrike",
    "category": "IT Security",
    "confidence": "medium",
    "first_detected": "2025-08-20",
    "last_detected": "2026-02-28",
    "is_favourite": true
  }
]