Retrieve a deal

Retrieve an existing deal

To retrieve a deal, the following permissions are required.

  • Deal permission: the user should have permission to manage deals.
  • Pipeline-specific permission: the user should have permission to manage the pipeline that the deal belongs to. If the user does not have the permission to manage the pipeline, limited deal data are returned with only id, title, and isDisabled set to true.
{
  "deal": {
    "owner": "1",
    "contact": "39",
    "organization": "20",
    "group": "1",
    "stage": "2",
    "title": "Able Hyena",
    "description": "Article do skill hope.",
    "percent": "0",
    "cdate": "2019-09-06T11:29:48-05:00",
    "mdate": "2019-09-06T11:29:48-05:00",
    "nextdate": null,
    "nexttaskid": null,
    "value": "1872151",
    "currency": "usd",
    "winProbability": 44,
    "winProbabilityMdate": "2019-10-05T12:27:22-05:00",
    "status": "0",
    "activitycount": "1",
    "nextdealid": "46",
    "edate": "2019-11-22 14:15:37",
    "links": {
    	"dealActivities": "/api/3/deals/46/dealActivities",
    	"contact":/api/3/deals/46/contact",
    	"contactDeals": "/api/3/deals/46/contactDeals",
    	"group": "/api/3/deals/46/group",
    	"nextTask": "/api/3/deals/46/nextTask",
    	"notes": "/api/3/deals/46/notes",
    	"account": "/api/3/deals/46/account",
    	"customerAccount": "/api/3/deals/46/customerAccount",
    	"organization": "/api/3/deals/46/organization",
    	"owner": "/api/3/deals/46/owner",
    	"scoreValues": "/api/3/deals/46/scoreValues",
    	"stage": "/api/3/deals/46/stage",
    	"tasks": "api/3/deals/46/tasks",
    	"dealCustomFieldData": "/api/3/deals/46/dealCustomFieldData"
    },
    "id": "46",
    "isDisabled": false,
    "account": "20",
    "customerAccount": "20"
    }
}
Language
Authorization
Header
URL