---
updatedAt: 2026-08-21T18:37:58.000Z
agentTools:
  projectIndex: https://docs.apollo.io/llms.txt
---

# View Associated Deals

 

<table>
  <thead>
    <tr style="background-color :#FEFFD9; color:#000000">
      <th colspan="2" align="left">Endpoint essentials</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><strong>API key access</strong></td>
      <td><code>deals/api/v1/opportunities/search</code> or <code>Master API key</code></td>
    </tr>
    <tr>
      <td><strong>OAuth scopes</strong></td>
      <td><code>opportunities_list</code></td>
    </tr>
    <tr>
      <td><strong>Credit usage</strong></td>
      <td><code>0 credits</code><br><a href="https://docs.apollo.io/docs/api-pricing">Learn more about API pricing and credits</a>.</td>
    </tr>
  </tbody>
</table>

<a href="https://knowledge.apollo.io/hc/en-us/articles/4415062467725-Deals-Overview" target="_blank">Deals</a> on Apollo help you track sales opportunities.<br><br>Use the view associated deals endpoint to retrieve the deals associated with a contact.<br><br>This endpoint doesn't require a request body. If you include one, Apollo doesn't read its fields. An empty JSON <code>{}</code> is sufficient.<br><br>Each result returns the same deal details as <a href="https://docs.apollo.io/reference/view-deal">view deal</a> endpoint. If the contact has no associated deals or the contact ID isn't recognized, Apollo returns a <code>200</code> response with an empty array rather than a <code>404</code> error.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "apollo-rest-api",
    "summary": "Programmatic access to Apollo's sales intelligence and engagement platform — data enrichment, prospect and company search, and go-to-market workflow management.",
    "description": "The Apollo API provides programmatic access to [Apollo](https://www.apollo.io/), the all-in-one sales intelligence and engagement platform. Use it to enrich people and company data (individually or in bulk), search Apollo's database of over 240 million contacts and 30 million companies, and manage accounts, contacts, deals, sequences, tasks, calls, and conversations in your go-to-market workflows.\n\n## Base URL\n\nAll API requests are made to `https://api.apollo.io/api/v1`.\n\n## Authentication\n\n- **Apollo users** authenticate with an API key passed in the `x-api-key` request header. See [Create API Keys](https://docs.apollo.io/docs/create-api-key).\n- **Apollo partners** building integrations on behalf of mutual users authenticate with the [OAuth 2.0 authorization flow](https://docs.apollo.io/docs/use-oauth-20-authorization-flow-to-access-apollo-user-information-partners).\n\n## Rate limits & credits\n\nRate limits and credit consumption depend on your [Apollo pricing plan](https://docs.apollo.io/docs/api-pricing). Check your current limits and usage with the [view API usage stats and rate limits](https://docs.apollo.io/reference/view-api-usage-stats) endpoint. For more details, see [Rate Limits](https://docs.apollo.io/reference/rate-limits) and the [API FAQs](https://docs.apollo.io/docs/apollo-api-faqs).\n\nNew to the API? Start with the [Apollo API overview](https://docs.apollo.io/reference/apollo-api).",
    "termsOfService": "https://www.apollo.io/terms/api",
    "contact": {
      "name": "Apollo API Support",
      "url": "https://docs.apollo.io/"
    },
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.apollo.io/api/v1"
    }
  ],
  "tags": [
    {
      "name": "Contacts",
      "description": "Create, update, and search the people your team saves in Apollo."
    }
  ],
  "components": {
    "securitySchemes": {
      "apiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key",
        "description": "[Recommended] API key, passed in the `x-api-key` request header.\nSee [Create API Keys](https://docs.apollo.io/docs/create-api-key)."
      },
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "OAuth 2.0 access token, used by Apollo partners building integrations.\nSee the [OAuth 2.0 authorization flow](https://docs.apollo.io/docs/use-oauth-20-authorization-flow-to-access-apollo-user-information-partners)."
      }
    },
    "schemas": {
      "ErrorDetails": {
        "type": "object",
        "description": "Machine-readable detail for an error that uses the new format, returned alongside the endpoint's existing error fields. The legacy error fields at the root level (`error`, `error_code`, `message`, etc) are removed on 2027-02-16, after which `error_details` is the only error payload. Some errors already return `error_details` on its own.",
        "properties": {
          "code": {
            "type": "string",
            "description": "Stable identifier in the form `DOMAIN.CATEGORY.REASON`. Branch on this value; the human-readable `message` can change.",
            "example": "AUTH.AUTHENTICATION.CREDENTIALS_MISSING"
          },
          "message": {
            "type": "string",
            "description": "Human-readable explanation of what went wrong.",
            "example": "This request carried no credential Apollo could authenticate."
          },
          "suggestions": {
            "type": "array",
            "description": "Ordered, actionable next steps. Each entry carries a `label`, and where relevant the `parameter`, `header`, or `url` it refers to.",
            "items": {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string",
                  "example": "Send your API key in the X-Api-Key header"
                },
                "url": {
                  "type": "string",
                  "example": "https://docs.apollo.io/reference/authentication"
                },
                "parameter": {
                  "type": "string",
                  "example": "webhook_url"
                },
                "parameters": {
                  "type": "array",
                  "description": "Several parameters, any one of which satisfies the requirement.",
                  "items": {
                    "type": "string"
                  },
                  "example": [
                    "name",
                    "domain",
                    "website_url",
                    "linkedin_url"
                  ]
                },
                "header": {
                  "type": "string",
                  "example": "X-Api-Key"
                },
                "example": {
                  "type": "string",
                  "description": "A valid sample value for the parameter named above."
                },
                "retry_after_seconds": {
                  "type": "integer",
                  "description": "On a rate-limit refusal, how long to wait before retrying.",
                  "example": 60
                }
              }
            }
          },
          "context": {
            "type": "object",
            "description": "Values from your request that explain the refusal. Each entry is an object rather than a bare value, so read `context.<key>.value`. Absent when the error needs no context.",
            "additionalProperties": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                }
              }
            },
            "example": {
              "window": {
                "value": "hourly",
                "description": "The rate-limit window your request exceeded"
              }
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "apiKey": []
    },
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/contacts/{contact_id}/opportunities": {
      "post": {
        "summary": "View associated deals",
        "description": "## Endpoint essentials\n\n**API key access:** `deals/api/v1/opportunities/search` or `Master API key`\n\n**OAuth scopes:** `opportunities_list`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\n<a href=\"https://knowledge.apollo.io/hc/en-us/articles/4415062467725-Deals-Overview\" target=\"_blank\">Deals</a> on Apollo help you track sales opportunities.<br><br>Use the view associated deals endpoint to retrieve the deals associated with a contact.<br><br>This endpoint doesn't require a request body. If you include one, Apollo doesn't read its fields. An empty JSON <code>{}</code> is sufficient.<br><br>Each result returns the same deal details as <a href=\"https://docs.apollo.io/reference/view-deal\">view deal</a> endpoint. If the contact has no associated deals or the contact ID isn't recognized, Apollo returns a <code>200</code> response with an empty array rather than a <code>404</code> error.",
        "tags": [
          "Contacts"
        ],
        "operationId": "view-associated-deals",
        "parameters": [
          {
            "name": "contact_id",
            "in": "path",
            "required": true,
            "description": "The ID for the contact whose associated deals you want to retrieve. <br><br>Example: <code>64a7ff0cc4dfae00013df1a5</code>",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {}
              },
              "examples": {
                "Empty body": {
                  "value": {}
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Contact with associated deals": {
                    "value": {
                      "opportunities": [
                        {
                          "id": "66e09ea8e3cfcf01b2208ec7",
                          "team_id": "6095a710bd01d100a506d4ac",
                          "owner_id": "66302798d03b9601c7934ebf",
                          "salesforce_owner_id": null,
                          "amount": 99999999,
                          "closed_date": null,
                          "account_id": "60afffecbff6de00a4b82be7",
                          "description": null,
                          "is_closed": false,
                          "is_won": false,
                          "name": "Massive Space Deal",
                          "stage_name": null,
                          "opportunity_stage_id": "6095a710bd01d100a506d4bd",
                          "source": "api",
                          "salesforce_id": null,
                          "created_at": "2024-09-10T19:31:52.436Z",
                          "actual_close_date": null,
                          "next_step": null,
                          "next_step_date": null,
                          "closed_lost_reason": null,
                          "closed_won_reason": null,
                          "forecast_category": "pipeline",
                          "deal_probability": 10,
                          "created_by_id": "60affe7d6e270a00f5db6fe4",
                          "current_solutions": null,
                          "deal_source": null,
                          "manually_updated_probability": null,
                          "manually_updated_forecast": null,
                          "crm_id": null,
                          "crm_record_url": null,
                          "crm_owner_id": null,
                          "probability": null,
                          "opportunity_pipeline_id": "654b989fcb2a5200010a90db",
                          "stage_updated_at": "2024-09-10T19:33:40.529+00:00",
                          "next_step_last_updated_at": null,
                          "exchange_rate_code": "USD",
                          "exchange_rate_value": 1,
                          "amount_in_team_currency": 99999999,
                          "forecasted_revenue": 9999999.9,
                          "last_activity_date": "2024-09-10T19:33:40.529Z",
                          "existence_level": "full",
                          "typed_custom_fields": {},
                          "opportunity_rule_config_statuses": [],
                          "opportunity_contact_roles": [
                            {
                              "id": "64a7ff0cc4dfae00013df1a5",
                              "role": "Decision Maker",
                              "contact": {
                                "id": "64a7ff0cc4dfae00013df1a5",
                                "name": "Tim Zheng",
                                "first_name": "Tim",
                                "last_name": "Zheng"
                              }
                            }
                          ],
                          "currency": {
                            "name": "US Dollar",
                            "iso_code": "USD",
                            "symbol": "$"
                          },
                          "num_contacts": 1,
                          "account": {
                            "id": "60afffecbff6de00a4b82be7",
                            "domain": "nasa.gov",
                            "name": "NASA - National Aeronautics and Space Administration",
                            "team_id": "6095a710bd01d100a506d4ac",
                            "organization_id": "55e16cfbf3e5bb66cf0026f3",
                            "account_stage_id": "6095a710bd01d100a506d4b9",
                            "source": "deployment",
                            "original_source": "deployment",
                            "creator_id": null,
                            "owner_id": null,
                            "created_at": "2021-05-27T20:24:12.644Z",
                            "phone": "+1 202-555-0117",
                            "phone_status": "no_status",
                            "hubspot_id": null,
                            "salesforce_id": null,
                            "crm_owner_id": null,
                            "parent_account_id": null,
                            "linkedin_url": null,
                            "sanitized_phone": "+12025550117",
                            "account_playbook_statuses": [],
                            "account_rule_config_statuses": [],
                            "existence_level": "full",
                            "label_ids": [],
                            "typed_custom_fields": {},
                            "custom_field_errors": null,
                            "modality": "account",
                            "source_display_name": "Requested from Apollo",
                            "crm_record_url": null,
                            "contact_emailer_campaign_ids": [],
                            "contact_campaign_status_tally": {},
                            "num_contacts": 1,
                            "last_activity_date": null
                          }
                        }
                      ]
                    }
                  },
                  "Contact with no associated deals": {
                    "value": {
                      "opportunities": []
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "opportunities": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "example": "66e09ea8e3cfcf01b2208ec7"
                          },
                          "team_id": {
                            "type": "string",
                            "example": "6095a710bd01d100a506d4ac"
                          },
                          "owner_id": {
                            "type": "string",
                            "example": "66302798d03b9601c7934ebf"
                          },
                          "salesforce_owner_id": {},
                          "amount": {
                            "type": "integer",
                            "example": 99999999,
                            "default": 0
                          },
                          "closed_date": {},
                          "account_id": {
                            "type": "string",
                            "example": "60afffecbff6de00a4b82be7"
                          },
                          "description": {},
                          "is_closed": {
                            "type": "boolean",
                            "example": false,
                            "default": true
                          },
                          "is_won": {
                            "type": "boolean",
                            "example": false,
                            "default": true
                          },
                          "name": {
                            "type": "string",
                            "example": "Massive Space Deal"
                          },
                          "stage_name": {},
                          "opportunity_stage_id": {
                            "type": "string",
                            "example": "6095a710bd01d100a506d4bd"
                          },
                          "source": {
                            "type": "string",
                            "example": "api"
                          },
                          "salesforce_id": {},
                          "created_at": {
                            "type": "string",
                            "example": "2024-09-10T19:31:52.436Z"
                          },
                          "actual_close_date": {},
                          "next_step": {},
                          "next_step_date": {},
                          "closed_lost_reason": {},
                          "closed_won_reason": {},
                          "forecast_category": {
                            "type": "string",
                            "example": "pipeline"
                          },
                          "deal_probability": {
                            "type": "integer",
                            "example": 10,
                            "default": 0
                          },
                          "created_by_id": {
                            "type": "string",
                            "example": "60affe7d6e270a00f5db6fe4"
                          },
                          "current_solutions": {},
                          "deal_source": {},
                          "manually_updated_probability": {},
                          "manually_updated_forecast": {},
                          "crm_id": {},
                          "crm_record_url": {},
                          "crm_owner_id": {},
                          "probability": {},
                          "opportunity_pipeline_id": {
                            "type": "string",
                            "example": "654b989fcb2a5200010a90db"
                          },
                          "stage_updated_at": {
                            "type": "string",
                            "example": "2024-09-10T19:33:40.529+00:00"
                          },
                          "next_step_last_updated_at": {},
                          "exchange_rate_code": {
                            "type": "string",
                            "example": "USD"
                          },
                          "exchange_rate_value": {
                            "type": "integer",
                            "example": 1,
                            "default": 0
                          },
                          "amount_in_team_currency": {
                            "type": "integer",
                            "example": 99999999,
                            "default": 0
                          },
                          "forecasted_revenue": {
                            "type": "number",
                            "example": 9999999.9,
                            "default": 0
                          },
                          "last_activity_date": {
                            "type": "string",
                            "example": "2024-09-10T19:33:40.529Z"
                          },
                          "existence_level": {
                            "type": "string",
                            "example": "full"
                          },
                          "typed_custom_fields": {
                            "type": "object",
                            "properties": {}
                          },
                          "opportunity_rule_config_statuses": {
                            "type": "array"
                          },
                          "opportunity_contact_roles": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "example": "64a7ff0cc4dfae00013df1a5"
                                },
                                "role": {
                                  "type": "string",
                                  "example": "Decision Maker"
                                },
                                "contact": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "string",
                                      "example": "64a7ff0cc4dfae00013df1a5"
                                    },
                                    "name": {
                                      "type": "string",
                                      "example": "Tim Zheng"
                                    },
                                    "first_name": {
                                      "type": "string",
                                      "example": "Tim"
                                    },
                                    "last_name": {
                                      "type": "string",
                                      "example": "Zheng"
                                    }
                                  }
                                }
                              }
                            }
                          },
                          "currency": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "example": "US Dollar"
                              },
                              "iso_code": {
                                "type": "string",
                                "example": "USD"
                              },
                              "symbol": {
                                "type": "string",
                                "example": "$"
                              }
                            }
                          },
                          "num_contacts": {
                            "type": "integer",
                            "example": 1,
                            "default": 0
                          },
                          "account": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "example": "60afffecbff6de00a4b82be7"
                              },
                              "domain": {
                                "type": "string",
                                "example": "nasa.gov"
                              },
                              "name": {
                                "type": "string",
                                "example": "NASA - National Aeronautics and Space Administration"
                              },
                              "team_id": {
                                "type": "string",
                                "example": "6095a710bd01d100a506d4ac"
                              },
                              "organization_id": {
                                "type": "string",
                                "example": "55e16cfbf3e5bb66cf0026f3"
                              },
                              "account_stage_id": {
                                "type": "string",
                                "example": "6095a710bd01d100a506d4b9"
                              },
                              "source": {
                                "type": "string",
                                "example": "deployment"
                              },
                              "original_source": {
                                "type": "string",
                                "example": "deployment"
                              },
                              "creator_id": {},
                              "owner_id": {},
                              "created_at": {
                                "type": "string",
                                "example": "2021-05-27T20:24:12.644Z"
                              },
                              "phone": {
                                "type": "string",
                                "example": "+1 202-555-0117"
                              },
                              "phone_status": {
                                "type": "string",
                                "example": "no_status"
                              },
                              "hubspot_id": {},
                              "salesforce_id": {},
                              "crm_owner_id": {},
                              "parent_account_id": {},
                              "linkedin_url": {},
                              "sanitized_phone": {
                                "type": "string",
                                "example": "+12025550117"
                              },
                              "account_playbook_statuses": {
                                "type": "array"
                              },
                              "account_rule_config_statuses": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "_id": {
                                      "type": "string",
                                      "example": "6466e8047759270001e53509"
                                    },
                                    "created_at": {},
                                    "rule_action_config_id": {
                                      "type": "string",
                                      "example": "64650edd434f8f00a3b13938"
                                    },
                                    "rule_config_id": {
                                      "type": "string",
                                      "example": "64650edd434f8f00a3b13939"
                                    },
                                    "status_cd": {
                                      "type": "string",
                                      "example": "completed"
                                    },
                                    "updated_at": {},
                                    "id": {
                                      "type": "string",
                                      "example": "6466e8047759270001e53509"
                                    },
                                    "key": {
                                      "type": "string",
                                      "example": "6466e8047759270001e53509"
                                    }
                                  }
                                }
                              },
                              "existence_level": {
                                "type": "string",
                                "example": "full"
                              },
                              "label_ids": {
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "example": "6466e8261e13be000133f25d"
                                }
                              },
                              "typed_custom_fields": {
                                "type": "object",
                                "properties": {}
                              },
                              "custom_field_errors": {},
                              "modality": {
                                "type": "string",
                                "example": "account"
                              },
                              "source_display_name": {
                                "type": "string",
                                "example": "Requested from Apollo"
                              },
                              "crm_record_url": {},
                              "contact_emailer_campaign_ids": {
                                "type": "array"
                              },
                              "contact_campaign_status_tally": {
                                "type": "object",
                                "properties": {}
                              },
                              "num_contacts": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              },
                              "last_activity_date": {}
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "text/plain": {
                "examples": {
                  "Check API key": {
                    "value": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate."
                  }
                }
              }
            }
          },
          "429": {
            "description": "429",
            "content": {
              "application/json": {
                "examples": {
                  "Too many requests": {
                    "value": {
                      "message": "The maximum number of api calls allowed for api/v1/contacts/{contact_id}/opportunities is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.",
                      "error_details": {
                        "code": "USAGE.RATE_LIMIT.API_RATE_LIMIT_EXCEEDED",
                        "message": "You have made more API requests than your plan allows in this time window.",
                        "suggestions": [
                          {
                            "label": "Wait until the rate limit resets, then retry the API request."
                          },
                          {
                            "label": "Check the Apollo Docs to understand API rate limits and how to use response headers to prevent rate-limit errors.",
                            "url": "https://docs.apollo.io/reference/rate-limits"
                          }
                        ],
                        "context": {
                          "window": {
                            "value": "hour",
                            "description": "The rate limit window that was exhausted, such as \"minute\" or \"hour\""
                          }
                        }
                      }
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "error_details": {
                      "$ref": "#/components/schemas/ErrorDetails"
                    },
                    "message": {
                      "deprecated": true,
                      "description": "Legacy error field. Removed on 2027-02-16, after which `error_details` is the only error payload.",
                      "type": "string",
                      "example": "The maximum number of api calls allowed for api/v1/contacts/{contact_id}/opportunities is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade."
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "Cache-Control",
        "value": "no-cache"
      },
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```