pharcel

Enterprise · API & Developers

Every agent and data pipeline, available as an API

A clean, versioned REST API puts pharcel's agents and data graph directly into your own applications and workflows, with SDKs, webhooks, and a sandbox to build against from day one.

Quickstart

A single request to search and verify HCPs

POST /v1/hcp/search
curl https://api.pharcel.ai/v1/hcp/search \
  -H "Authorization: Bearer $PHARCEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "indication": "hypophosphatasia",
    "country": "CA",
    "specialties": ["endocrinology", "medical genetics"],
    "limit": 25
  }'

# Response
{
  "object": "hcp.search",
  "count": 25,
  "data": [
    {
      "id": "hcp_9Qb3xK2",
      "full_name": "Aren W. Carleton",
      "specialty": "Medical Genetics",
      "institution": "Toronto General Hospital",
      "confidence": "CONFIRMED",
      "evidence": ["pubmed", "clinicaltrials_gov", "institution"],
      "h_index": 34
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjI1fQ"
}

Built for developers

Everything you need to build with confidence

Authentication

Authenticate with scoped API keys or OAuth 2.0 client credentials. Keys are per-environment, rotatable, and restrictable to specific endpoints and datasets.

Webhooks

Subscribe to events, agent runs, enrichment completion, HCP updates, and receive signed, retried callbacks to drive real-time downstream automation.

Rate limits

Generous, tier-based rate limits with clear headers and 429 backoff guidance. Burst and sustained limits are documented per endpoint.

SDKs

First-class TypeScript and Python SDKs with typed models, pagination helpers, and automatic retries, so you ship integrations in hours, not weeks.

Sandbox environment

Build and test against a fully isolated sandbox with realistic synthetic data before you ever touch production or real HCP records.

Versioning

Date-based API versioning with long deprecation windows and changelogs. Pin a version and upgrade on your own schedule, nothing breaks under you.

Endpoints

A REST surface across agents and data

POST/v1/hcp/search

Discover and verify HCPs across an indication, geography, and specialty.

GET/v1/hcp/{id}

Retrieve a resolved HCP profile with evidence, publications, and trials.

POST/v1/agents/{agent}/runs

Trigger an agent run, targeting, territory design, or enrichment.

GET/v1/agents/runs/{id}

Poll run status, outputs, and audit metadata.

POST/v1/territories/optimize

Generate or rebalance territories against live field and market data.

POST/v1/webhooks

Register a signed webhook subscription for platform events.

Start building with the pharcel API

Get sandbox access, API keys, and full reference documentation, and talk to our engineers about your integration.