Retrieve a list of contact's deals

The deals this contact is on as a secondary contact, as contact-to-deal links. Each link carries the deal id (deal), the contact id (contact), the contact's role on the deal (role, null when none) and when the link was made (cdate). Deals where this contact is the primary contact are not listed here; GET /contacts/{id}/deals returns those. Every link comes back in one response: limit and offset are ignored on this path, and no order is guaranteed. The linked deals are sideloaded in deals and their primary contacts in contacts. A user without the permission to list all deals sees only links to deals they own. Returns 404 if the contact does not exist. For deal links across contacts, or to page through them, use GET /contactDeals with filters[deal] and filters[contact].

{
    "contacts": [
        {
            "cdate": "2021-11-28T00:00:00-06:00",
            "email": "[email protected]",
            "phone": "555-555-5555",
            "firstName": "John",
            "lastName": "Doe",
            "orgid": "XX",
            "orgname": "Opulence Time",
            "segmentio_id": "",
            "bounced_hard": "0",
            "bounced_soft": "0",
            "bounced_date": "0000-00-00",
            "ip": "0",
            "ua": "",
            "hash": "43fa9ikvd23cbc59915f89asd234gsda27b33",
            "socialdata_lastcheck": "0000-00-00 00:00:00",
            "email_local": "",
            "email_domain": "",
            "sentcnt": "0",
            "rating_tstamp": "0000-00-00",
            "gravatar": "0",
            "deleted": "0",
            "anonymized": "0",
            "adate": "2021-11-28T00:00:00-06:00",
            "udate": "2021-11-28T00:00:00-06:00",
            "edate": "2021-12-20T06:23:31-06:00",
            "deleted_at": "0000-00-00 00:00:00",
            "created_utc_timestamp": "2021-11-28 00:00:00",
            "updated_utc_timestamp": "2022-01-25 16:26:37",
            "created_timestamp": "2021-11-28 00:00:00",
            "updated_timestamp": "2021-12-09 00:00:00",
            "created_by": "0",
            "updated_by": "0",
            "email_empty": false,
            "mpp_tracking": "0",
            "links": {
                "bounceLogs": "https://:account.api-us1.com/api/3/contacts/1107/bounceLogs",
                "contactAutomations": "https://:account.api-us1.com/api/3/contacts/1107/contactAutomations?limit=1000&orders%5Blastdate%5D=DESC",
                "contactData": "https://:account.api-us1.com/api/3/contacts/1107/contactData",
                "contactGoals": "https://:account.api-us1.com/api/3/contacts/1107/contactGoals",
                "contactLists": "https://:account.api-us1.com/api/3/contacts/1107/contactLists",
                "contactLogs": "https://:account.api-us1.com/api/3/contacts/1107/contactLogs",
                "contactTags": "https://:account.api-us1.com/api/3/contacts/1107/contactTags",
                "contactDeals": "https://:account.api-us1.com/api/3/contacts/1107/contactDeals",
                "deals": "https://:account.api-us1.com/api/3/contacts/1107/deals",
                "fieldValues": "https://:account.api-us1.com/api/3/contacts/1107/fieldValues",
                "geoIps": "https://:account.api-us1.com/api/3/contacts/1107/geoIps",
                "notes": "https://:account.api-us1.com/api/3/contacts/1107/notes",
                "organization": "https://:account.api-us1.com/api/3/contacts/1107/organization",
                "plusAppend": "https://:account.api-us1.com/api/3/contacts/1107/plusAppend",
                "trackingLogs": "https://:account.api-us1.com/api/3/contacts/1107/trackingLogs",
                "scoreValues": "https://:account.api-us1.com/api/3/contacts/1107/scoreValues",
                "accountContacts": "https://:account.api-us1.com/api/3/contacts/1107/accountContacts",
                "automationEntryCounts": "https://:account.api-us1.com/api/3/contacts/1107/automationEntryCounts"
            },
            "id": "XXXX",
            "organization": "XX"
        }
    ],
    "deals": [
        {
            "hash": "dx60eh125",
            "owner": "8",
            "contact": "XXXX",
            "organization": "31",
            "group": "1",
            "stage": "1",
            "title": "Opulence Time",
            "description": "",
            "percent": "0",
            "cdate": "2022-01-24T00:00:00-06:00",
            "mdate": "2022-01-25T00:00:00-06:00",
            "nextdate": null,
            "nexttaskid": "0",
            "value": "7320163",
            "currency": "usd",
            "winProbability": null,
            "winProbabilityMdate": null,
            "status": "0",
            "activitycount": "24",
            "nextdealid": "4218",
            "edate": "2022-03-07 00:00:00",
            "links": {
                "dealActivities": "https://:account.api-us1.com/api/3/deals/4228/dealActivities",
                "contact": "https://:account.api-us1.com/api/3/deals/4228/contact",
                "contactDeals": "https://:account.api-us1.com/api/3/deals/4228/contactDeals",
                "group": "https://:account.api-us1.com/api/3/deals/4228/group",
                "nextTask": "https://:account.api-us1.com/api/3/deals/4228/nextTask",
                "notes": "https://:account.api-us1.com/api/3/deals/4228/notes",
                "account": "https://:account.api-us1.com/api/3/deals/4228/account",
                "customerAccount": "https://:account.api-us1.com/api/3/deals/4228/customerAccount",
                "organization": "https://:account.api-us1.com/api/3/deals/4228/organization",
                "owner": "https://:account.api-us1.com/api/3/deals/4228/owner",
                "scoreValues": "https://:account.api-us1.com/api/3/deals/4228/scoreValues",
                "stage": "https://:account.api-us1.com/api/3/deals/4228/stage",
                "tasks": "https://:account.api-us1.com/api/3/deals/4228/tasks",
                "dealCustomFieldData": "https://:account.api-us1.com/api/3/deals/4228/dealCustomFieldData"
            },
            "id": "4228",
            "isDisabled": false,
            "nextTask": null,
            "account": "31",
            "customerAccount": "31"
        }
    ],
    "contactDeals": [
        {
            "deal": "4228",
            "contact": "5",
            "role": null,
            "cdate": "2021-10-22T13:16:27-05:00",
            "created_timestamp": "2021-10-22 13:16:27",
            "updated_timestamp": "2021-10-22 13:16:27",
            "created_by": null,
            "updated_by": null,
            "links": {
                "deal": "https://:account.api-us1.com/api/3/contactDeals/4248/deal",
                "contact": "https://:account.api-us1.com/api/3/contactDeals/4248/contact",
                "role": "https://:account.api-us1.com/api/3/contactDeals/4248/role"
            },
            "id": "4248"
        }
    ]
}
Path Params
int32
required

ID of the contact

Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Choose an example:
application/json