v1

latestOpenAPI 3.1.02026-07-247601.0 MB

Contacts

View Associated Deals

This endpoint doesn't consume Apollo credits. Learn more about API pricing and credits.

<a href="https://knowledge.apollo.io/hc/en-us/articles/4415062467725-Deals-Overview" target="_blank">Deals</a> on Apollo help you track sales opportunities. Use the View Associated Deals endpoint to retrieve the deals associated with a contact. 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. 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.

post/contacts/{contact_id}/opportunities

Path parameters

contact_idstring required

The ID for the contact whose associated deals you want to retrieve. Example: <code>64a7ff0cc4dfae00013df1a5</code>

Request body

object required

Response

200

Example response

{
  "opportunities": [
    {
      "id": "66e09ea8e3cfcf01b2208ec7",
      "team_id": "6095a710bd01d100a506d4ac",
      "owner_id": "66302798d03b9601c7934ebf",
      "amount": 99999999,
      "account_id": "60afffecbff6de00a4b82be7",
      "name": "Massive Space Deal",
      "opportunity_stage_id": "6095a710bd01d100a506d4bd",
      "source": "api",
      "created_at": "2024-09-10T19:31:52.436Z",
      "forecast_category": "pipeline",
      "deal_probability": 10,
      "created_by_id": "60affe7d6e270a00f5db6fe4",
      "opportunity_pipeline_id": "654b989fcb2a5200010a90db",
      "stage_updated_at": "2024-09-10T19:33:40.529+00:00",
      "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",
      "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",
        "created_at": "2021-05-27T20:24:12.644Z",
        "phone": "+1 202-555-0117",
        "phone_status": "no_status",
        "sanitized_phone": "+12025550117",
        "account_rule_config_statuses": [
          {
            "_id": "6466e8047759270001e53509",
            "rule_action_config_id": "64650edd434f8f00a3b13938",
            "rule_config_id": "64650edd434f8f00a3b13939",
            "status_cd": "completed",
            "id": "6466e8047759270001e53509",
            "key": "6466e8047759270001e53509"
          }
        ],
        "existence_level": "full",
        "label_ids": [
          "6466e8261e13be000133f25d"
        ],
        "modality": "account",
        "source_display_name": "Requested from Apollo"
      }
    }
  ]
}