Skip to main content
GET
/
api
/
v2
/
campaigns
/
search-by-contact
Search campaigns by lead email
curl --request GET \
  --url https://api.instantly.ai/api/v2/campaigns/search-by-contact \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "019cc043-aee6-7ae9-a545-d7de53430e37",
      "name": "My First Campaign",
      "status": 1,
      "campaign_schedule": {
        "schedules": [
          {
            "name": "My Schedule",
            "timing": {
              "from": "09:00",
              "to": "17:00"
            },
            "days": {
              "0": true,
              "1": true,
              "2": true,
              "3": true,
              "4": true,
              "5": false,
              "6": false
            },
            "timezone": "Etc/GMT+12"
          }
        ],
        "start_date": "2025-09-25",
        "end_date": "2025-09-25"
      },
      "timestamp_created": "2026-03-05T23:09:47.110Z",
      "timestamp_updated": "2026-03-05T23:09:47.110Z",
      "pl_value": 100,
      "is_evergreen": false,
      "sequences": [
        {
          "steps": [
            {
              "type": "email",
              "delay": 2,
              "variants": [
                {
                  "subject": "Hello {{firstName}}",
                  "body": "Hey {{firstName}},\n\nI hope you are doing well.",
                  "v_disabled": true
                }
              ],
              "delay_unit": "days",
              "pre_delay": 2,
              "pre_delay_unit": "days"
            }
          ]
        }
      ],
      "email_gap": 10,
      "random_wait_max": 10,
      "text_only": false,
      "first_email_text_only": false,
      "email_list": [
        "john@doe.com"
      ],
      "daily_limit": 100,
      "stop_on_reply": false,
      "email_tag_list": [
        "019cc043-aee6-7ae9-a545-d7df85a583a2"
      ],
      "link_tracking": true,
      "open_tracking": true,
      "stop_on_auto_reply": false,
      "daily_max_leads": 100,
      "prioritize_new_leads": false,
      "auto_variant_select": {
        "trigger": "reply_rate"
      },
      "match_lead_esp": false,
      "not_sending_status": 2,
      "stop_for_company": false,
      "core_variables": {},
      "custom_variables": {},
      "insert_unsubscribe_header": false,
      "allow_risky_contacts": false,
      "disable_bounce_protect": false,
      "limit_emails_per_company_override": {
        "mode": "custom",
        "daily_limit": 2,
        "scope": "per_campaign"
      },
      "cc_list": [
        "john@doe.com"
      ],
      "bcc_list": [
        "john@doe.com"
      ],
      "organization": "019cc043-aee6-7ae9-a545-d7e0e895498f",
      "owned_by": "019cc043-aee6-7ae9-a545-d7e131be967e",
      "ai_sdr_id": "019cc043-aee6-7ae9-a545-d7e2b38afb00",
      "provider_routing_rules": [
        {
          "action": "send",
          "recipient_esp": [
            "all"
          ],
          "sender_esp": [
            "all"
          ]
        }
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

Search by lead email

Example:

"lead-email@example.com"

sort_column
string
default:timestamp_created

Sort campaigns by column name

Example:

"timestamp_created"

sort_order
string
default:asc

Sort direction

Example:

"asc"

Response

Default Response

items
Campaign · object[]