Retrieve the details of all deal.
Request
GET
GET /v1/deal
Query Parameter
- sortOrder
integerField to sort by (e.g., first_name, last_name, created_at).
- sortByColumn
integerSort order (asc for ascending, desc for descending).
- page
integerThe page number for pagination.
- limit
integerNumber of deals per page.
- Maximize
stringThe
maximizeparameter allows you to specify which items to maximize in your API response.It is comma separated string values. The following values are allowed:ownercreated_byupdated_byorganizationjobcandidatestagecontact
Note: To maximize all the items in the response, you can pass 'all' as the value for the maximize query parameter.
Example usage:
GET /v1/deal?maximize=owner,stage,organization
Response
200
Body
- id
numberExample: 28
- slug
stringExample: contact_68ba678fcd2a83f4640c
- name
stringExample: Anjali kotwani
- stage
objectExample:
"id": 1,
"label": "win",
"percentage": "100" - deal_amount
numberExample: 22
- amount_by_stage
numberExample: 2.2
- close_date
stringExample: 1990-02-02
- deal_type
stringExample: "1"
- organization
objectExample:
"id": 1 - jobs
objectExample:
"id": 1 - candidates
objectExample:
"id": 1 - contacts
objectExample:
"id": 1 - tags
stringExample: [leader,java]
- created_at
string (ISO 8601 date)Example: 2015-05-15T00:00:00Z
- updated_at
string (ISO 8601 date)Example: 2015-05-15T00:00:00Z
- created_by
objectExample:
"id": 1,
"email": "Rohan@abc.com",
"first_name": "Rohan",
"last_name": "Sharma",
"full_name": "Rohan Sharma",
"role": "Admin",
"phone": null - updated_by
objectExample:
"id": 1,
"email": "Rohan@abc.com",
"first_name": "Rohan",
"last_name": "Sharma",
"full_name": "Rohan Sharma",
"role": "Admin",
"phone": null - owner
objectExample:
"id": 1,
"email": "Rohan@abc.com",
"first_name": "Rohan",
"last_name": "Sharma",
"full_name": "Rohan Sharma",
"role": "Admin",
"phone": null - custom fields:
objectExample:
"id": 1,
"field_name": "textfeild",
"field_type": "string",
"value": "anjali"
401
Error
- unauthorized
Response Example
{
"id": 11,
"slug": "deal_b93fc43d76fff40d6647",
"name": "software engineer",
"stage": {
"id": 4
},
"deal_amount": 11,
"amount_by_stage": 2.2,
"close_date": "2024-08-07",
"deal_type": 1,
"organization": {
"id": 8
},
"jobs": [],
"candidates": [],
"contacts": [],
"tags": null,
"created_at": "2024-08-06T13:33:00.000Z",
"updated_at": "2024-08-06T13:33:33.000Z",
"created_by": {
"id": 1,
"email": "Rohan@abc.com",
"first_name": "Rohan",
"last_name": "Sharma",
"full_name": "Rohan Sharma",
"role": "Admin",
"phone": null
},
"updated_by": {
"id": 1,
"email": "Rohan@abc.com",
"first_name": "Rohan",
"last_name": "Sharma",
"full_name": "Rohan Sharma",
"role": "Admin",
"phone": null
},
"owner": {
"id": 1,
"email": "Rohan@abc.com",
"first_name": "Rohan",
"last_name": "Sharma",
"full_name": "Rohan Sharma",
"role": "Admin",
"phone": null
},
"custom_fields": [
{
"id": 2,
"field_name": "test deal",
"field_type": "phone",
"value": ""
},
{
"id": 3,
"field_name": "File",
"field_type": "file",
"value": ""
},
{
"id": 1,
"field_name": "TEst after delete",
"field_type": "text",
"value": ""
}
]
}