# List the people enrichment suggests at one partner company

`GET https://api.suger.cloud/ai/org/{orgId}/prm/partnership/{partnershipId}/suggestedContact`

List the people company enrichment (Apollo or PDL) suggests at one partner company: name, email, job title, LinkedIn URL, seniority, and which one is the primary (highest-seniority) contact. Needs partners.read. `partnershipId` is the partnership id from ListPrmPartnerships.

These come from the company-enrichment record for the partner, so a partnership Fours has not enriched returns an empty array. An empty result is normal and common; it is not a failure: do not retry it, and do not report it as "this partner has no contacts" without saying where the list comes from.

These are suggestions, not the partnership's contacts. The people the partnership already has (its CRM Account's contacts, its partner-portal users, its deal registrations' team and those added in the hub) are ListPrmOrgPartnerContacts with `partnershipIds`. The partner's champion is `info.partnerChampionContact` on GetPrmPartnership, and ListPrmInvitations says who has been written to.

Here "partner" means a company in your own partner program, addressed by its partnership id. Do not confuse it with GetPartnerContacts, which returns cloud-provider representatives (AWS, Azure, GCP) for a customer company addressed by email domain.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgId` | path | string | yes | Organization ID |
| `partnershipId` | path | string | yes | Partnership ID |

## Responses

### 200 — OK

Content-Type: `application/json`

**`PartnerContact`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `apolloId` | string | no | ApolloID is the Apollo.io person ID for re-enrichment. |
| `crmContactId` | string | no | CrmContactID is the person's record under the linked CRM Account. |
| `email` | string | no | Email is the contact's verified email address. |
| `enrichedAt` | string | no | EnrichedAt is the RFC3339 timestamp of the last enrichment. |
| `firstName` | string | no |  |
| `id` | string | no | ID is the partnership_contact row id. Empty until someone acted on the person (added, edited, synced, removed); address such a person by email. |
| `invitationId` | string | no | InvitationID and InvitedAt describe the pending invitation when Portal is INVITED. |
| `invitedAt` | string | no |  |
| `isPrimary` | boolean | no | IsPrimary indicates this is the highest-seniority partnership contact. |
| `lastActivityAt` | string | no | LastActivityAt is the person's last sign-in to the partner portal. |
| `lastName` | string | no |  |
| `linkedinUrl` | string | no | LinkedinURL is the contact's LinkedIn profile URL. |
| `name` | string | no | Name is the contact's full name. |
| `ownDomain` | boolean | no | OwnDomain marks a person on the ISV's own email domain. Such rows are returned only with includeOwnDomain and are never synced, invited or made champion. |
| `phone` | string | no |  |
| `portal` | PrmContactPortalStatus | no |  |
| `role` | PrmContactRole | no |  |
| `seniority` | string | no | Seniority is the contact's seniority level (e.g., "vp", "director", "manager", "ic"). |
| `source` | PrmContactSource | no |  |
| `syncError` | string | no | SyncError is the CRM's error from the last failed sync, verbatim. |
| `syncStatus` | PrmContactSyncStatus | no |  |
| `title` | string | no | Title is the contact's job title/role (e.g., "VP of Partnerships"). |

### 404 — No such partnership in this organization

Content-Type: `application/json`

## Example

_Generated from this operation's schema. Values are placeholders — substitute your own ids, and set `SUGER_TOKEN` to a bearer token from the [OAuth client-credentials exchange](https://doc.fours.com/settings/oauth-app/)._

### Request

```bash
curl -X GET 'https://api.suger.cloud/ai/org/{orgId}/prm/partnership/{partnershipId}/suggestedContact' \
  -H "Authorization: Bearer $SUGER_TOKEN"
```

### Response — 200

```json
[
  {
    "apolloId": "01H0000000000000000000",
    "crmContactId": "01H0000000000000000000",
    "email": "buyer@example.com",
    "enrichedAt": "string",
    "firstName": "Acme Corp",
    "id": "01H0000000000000000000",
    "invitationId": "01H0000000000000000000",
    "invitedAt": "2026-01-31T12:00:00Z",
    "isPrimary": true,
    "lastActivityAt": "2026-01-31T12:00:00Z",
    "lastName": "Acme Corp",
    "linkedinUrl": "https://example.com"
  }
]
```

### Error — 404

```json
"string"
```

---

API reference: https://doc.fours.com/api/
