Bellwork
Start free
Opportunities

List opportunities

Agent-produced, verified sales opportunities for the caller's projects. Customers see only published rows (enforced by RLS); internal users also see drafts for concierge review. **Free (0 credits).**

GET
/opportunities

Agent-produced, verified sales opportunities for the caller's projects. Customers see only published rows (enforced by RLS); internal users also see drafts for concierge review. Free (0 credits).

Authorization

AuthorizationBearer <token>

API key (sk_live_... prefix). Generate keys in the UI under Settings > API Keys, then send it as Authorization: Bearer sk_live_...

In: header

Query Parameters

project_id?string

Filter by project

Formatuuid
status?string

Review status filter (internal users only)

Value in"draft" | "published" | "dismissed"
supplementary?string

Signal-based (false) vs ICP-fallback prospecting (true)

Value in"true" | "false"
limit?integer

Results per page

Default50
Rangevalue <= 200
offset?integer

Pagination offset

Default0

Response Body

application/json

application/json

application/json

curl -X GET "https://loading/api/v1/opportunities"
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
      "workflow_run_id": "string",
      "entity_type": "district",
      "district_id": "880bc4ee-477a-4e12-a0f0-c89f020ba05d",
      "school_id": "c1317ebe-519d-4c8a-9ab1-7bfd15017c1c",
      "geo_scope": "string",
      "title": "string",
      "signal_type": "string",
      "event_date": "string",
      "event_date_basis": "string",
      "why_now": "string",
      "suggested_action": "string",
      "confidence": 1,
      "caveats": "string",
      "source_urls": [
        "string"
      ],
      "signal_ids": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      ],
      "contacts": [
        {
          "contact_id": "f245e2a3-e141-4d41-912c-b1c1f5bd5598",
          "name": "string",
          "title": "string",
          "email": "string",
          "email_status": "string",
          "source": "string"
        }
      ],
      "suggested_prompts": [
        "string"
      ],
      "supplementary": true,
      "status": "draft",
      "published_at": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  ],
  "pagination": {
    "total": -9007199254740991,
    "limit": -9007199254740991,
    "offset": -9007199254740991,
    "has_more": true
  }
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}

Get list membership for entity GET

Check which lists a specific entity belongs to.

Review an opportunity (internal only) PATCH

Concierge review gate: publish a draft (makes it customer-visible) or dismiss it. **Internal/admin only** (requires the `internal` plan); other orgs receive 403. **Free (0 credits).**