Browse docsget_goal_match
get_goal_match
Reads one currently listed saved match and its authorized assessment.
Annotations: readOnlyHint: true · destructiveHint: false · idempotentHint: true · openWorldHint: false
Inputs#
| Input | Required | Description |
|---|---|---|
matchId | yes | Exact match UUID from a match collection or authorized conversation |
Returns#
The match resource directly: the same id, name, route, context, fit, introduction, and ownOutreach as a match summary, plus:
| Field | Description |
|---|---|
goalId | Parent goal identity |
goalOwnerName | Authorized display name of the member who owns the goal, or null |
viewerRole | goal_owner or connector |
beneficiary | { personId, name } for an owned goal for someone else, otherwise null |
assessedGoalText | Wording this assessment used; an earlier assessment is not reassessed for edited wording |
publicIdentity | Nullable headline, currentRole, and linkedInUrl from the safe LinkedIn projection; own-contact profiles use the separate person read |
assessment | Nullable object with summary, howTheyCouldHelp, whatTheBeneficiaryCouldOffer, valueToBeneficiary, and valueToCandidate |
memberSuppliedReason | The member's reason for suggesting this person, or null; it is not a model assessment |
offeredToBeneficiary | Whether the goal owner already offered this own contact to the beneficiary |
Strengths are borderline_yes, clear_yes, strong_yes, or null. They refer to the named beneficiary, otherwise the goal owner. A hand-added match has its member's reason and a null assessment. A personal offer originating from a search can retain coarse strengths without private assessment prose.
For route.kind: "own_contact", use its personId with get_person for your own contact's profile and relationship context. Through-member requester views contain only the safe name, selected public LinkedIn fields, requester-safe explanation, and coarse strengths. They never carry the other owner's person ID, contact details, relationship context, or private evidence. Connector reads concern their own contacts; MCP adds no connector collection discovery.
Missing, inaccessible, unlisted, and ended-goal matches return unavailable. This Get does not read archived match history. Nothing is refreshed, chosen, approved, or sent. A match establishes neither willingness nor a successful introduction. Open the returned goal link to discuss or act in Gravity.
Example#
{
"matchId": "00000000-0000-4000-a000-000000000002"
}
Result (synthetic data):
{
"id": "00000000-0000-4000-a000-000000000002",
"name": "Synthetic candidate",
"route": { "kind": "through_member", "connector": { "memberId": "00000000-0000-4000-a000-000000000003", "name": "Synthetic connector" } },
"context": "current",
"fit": "potential_win_win",
"introduction": "not_requested",
"ownOutreach": null,
"goalId": "00000000-0000-4000-a000-000000000001",
"goalOwnerName": "Synthetic requester",
"viewerRole": "goal_owner",
"beneficiary": null,
"assessedGoalText": "Find design partners",
"publicIdentity": { "headline": "Public headline", "currentRole": "Public role", "linkedInUrl": null },
"assessment": { "summary": "Possible design partner", "howTheyCouldHelp": "Could discuss the product", "whatTheBeneficiaryCouldOffer": "Product feedback", "valueToBeneficiary": "clear_yes", "valueToCandidate": "borderline_yes" },
"memberSuppliedReason": null,
"offeredToBeneficiary": false
}