AI Leads Engine

Lead records

Every person, company and job this workspace has brought in, from any list, import or search, one record per real lead. Read-only. Contact details come from your own copy of each lead.

GET/v1/owned-leadsList lead records GET/v1/owned-leads/{id}Get a lead record

List lead records

GET/api/v1/owned-leads

In record id order. Pass next back as after for the following page.

Any API key, read-only included.

Parameters

Name	Type	Description
`type` query	string	person, company or job.
`after` query	integer	The next value of the previous page.
`limit` query	integer	Up to 100. Default 25.

Errors

401Missing or invalid key
422Invalid input, or not ready; the body has message and an errors object, one entry per field
429More than 120 requests a minute

Request

curl https://app.zicreach.com/api/v1/owned-leads \
  -H "Authorization: Bearer zk_your_key"

Response200

{
    "data": [
        {
            "id": 1042,
            "type": "person",
            "source": "csv",
            "acquired_at": "2026-10-02 10:00:00",
            "lead_id": "9d1c6a2e-4b7f-4e0a-9a51-2f8c3b6d7e10",
            "name": "Jane Doe",
            "title": "Founder & CEO",
            "company": "Example Ltd",
            "domain": "example.com",
            "email": "jane@example.com"
        }
    ],
    "next": 1043
}

Get a lead record

GET/api/v1/owned-leads/{id}

One record this workspace holds; any other id is 404.

Any API key, read-only included.

Parameters

Name	Type	Description
`id`required path	integer	Record id.

Errors

401Missing or invalid key
404Not found in this workspace
422Invalid input, or not ready; the body has message and an errors object, one entry per field
429More than 120 requests a minute

Request

curl https://app.zicreach.com/api/v1/owned-leads/1042 \
  -H "Authorization: Bearer zk_your_key"

Response200

{
    "data": {
        "id": 1042,
        "type": "person",
        "name": "Jane Doe",
        "company": "Example Ltd"
    }
}