Deal active status meaning

I have some deal from the API that have the following fields

active: false
deleted: false

The documentation says that active means “If the Deal is activated or not”. I usually only see this as false when deleted is true.

Could I get some more insight on what “active” means and perhaps how a deal gets into that state?

Thanks in advance for any help.

Hey Kenton,

What does is say under status (right below ‘deleted’)?

lost

If it helps, here’s the deal info with some likely irrelevant details redacted.

{
	"id": 7786,
	"creator_user_id": {
		"id": 2668599,
		REDACTED
	},
	"user_id": {
		"id": 2668599,
		REDACTED
	},
	"person_id": null,
	"org_id": null,
	"stage_id": 161,
	"title": "REDACTED",
	"value": 0,
	"currency": "BRL",
	"add_time": "2018-07-20 00:00:09",
	"update_time": "2021-04-06 13:29:40",
	"stage_change_time": null,
	"active": false,
	"deleted": false,
	"status": "lost",
	"probability": null,
	"next_activity_date": null,
	"next_activity_time": null,
	"next_activity_id": null,
	"last_activity_id": null,
	"last_activity_date": null,
	"lost_reason": null,
	"visible_to": "3",
	"close_time": "2021-04-06 13:29:39",
	"pipeline_id": 33,
	"won_time": null,
	"first_won_time": null,
	"lost_time": "2021-04-06 13:29:39",
	"products_count": 0,
	"files_count": 0,
	"notes_count": 0,
	"followers_count": 1,
	"email_messages_count": 0,
	"activities_count": 0,
	"done_activities_count": 0,
	"undone_activities_count": 0,
	"participants_count": 0,
	"expected_close_date": null,
	"last_incoming_mail_time": null,
	"last_outgoing_mail_time": null,
	"label": null,
	  CUSTOM FEILDS REDACTED
	"renewal_type": "one_time",
	"stage_order_nr": 1,
	"person_name": null,
	"org_name": null,
	"next_activity_subject": null,
	"next_activity_type": null,
	"next_activity_duration": null,
	"next_activity_note": null,
	"group_id": null,
	"group_name": null,
	"formatted_value": "R$ 0",
	"rotten_time": null,
	"owner_name": "REDACTED",
	"cc_email": "REDACTED",
	"org_hidden": false,
	"person_hidden": false,
	"average_time_to_won": {
		"y": 0,
		"m": 0,
		"d": 0,
		"h": 0,
		"i": 0,
		"s": 0,
		"total_seconds": 0
	},
	"average_stage_progress": 0,
	"age": {
		"y": 2,
		"m": 8,
		"d": 17,
		"h": 13,
		"i": 29,
		"s": 30,
		"total_seconds": 85670970
	},
	"stay_in_pipeline_stages": {
		"times_in_stages": [],
		"order_of_stages": []
	},
	"last_activity": null,
	"next_activity": null
}

Thanks Kenton,

So with Deals, when their Status is Won or Lost, they will show both "active": false and "deleted": false.

This is because Deals are the only object that has a Status (Open, Won, Lost, Deleted)

"active": false & "deleted": false = Won/Lost

"active": true & "deleted": false = Open

"active": false & "deleted": true = Deleted

Thank you kindly for your help David. Much appreciated.

1 Like