I’m trying to retrieve all Deals, but the owner and description properties aren’t available. These seem basic/fundamental to me so I’m not sure why. Can anyone tell me if I’m missing anything?
Thank you.
Hey @BTaylor16,
Welcome and thanks for posting!
When using the Deals API, properties like owner and description aren’t returned by default, you’d need to explicitly request them in your API call.
(It’s also worth noting that the internal property names can differ from what you might expect)
Our guide on the matter should help point you in the right direction:
I’ll tag in a few of our Top Contributors in the meantime to see if they have any specific suggestions here!
Hey @GRajput, @SteveHTM, @zach_threadint -- do you have any suggestions for @BTaylor16 on this?
Thanks in advance!
Sam, Community Manager
Hi Sam,
Thanks for the response.
I have already been specifying specific properties in my requests and I am referencing the property names that I have already pulled from Hubspot. It’s just not working. My original post is from already trying lots of various methods to get the description returned to me, but nothing works.
Any further advice is welcome.
Kind regards,
Brent
@BTaylor16 - it is true that only a small number of property values are returned by default in the API calls. What counts as “fundamental” may differ from user to user. But it is easy to extend what’s returned by adding a “?properties=xxx_propertyA,xxx_propertyB” type of extension to the API URL. Check the actual names in the properties settings dialog - or via the schema API call.
I hope this is helpful.
Steve
Hi Steve,
Thanks for the quick response.
Just for context, I have already tried your suggestion in various combinations. In fact, I feel like I have tried many methods to get the description returned to me. It’s just not working. I’m not getting errors, I am able to get some other properties such as amount, but description is not coming through when I query deals or even a specific deal based on id. I also find it odd that the owner name cannot be returned from any of the endpoints, just the owner id.
Any advice is welcome.
I can verify that an example API call with “?properties=description” appended correctly returns any set description string.
{
"id": "56383560305",
"properties": {
"createdate": "2026-02-16T16:37:39.412Z",
"description": "A deal descrption",
"hs_lastmodifieddate": "2026-04-10T14:12:13.144Z",
"hs_object_id": "56383560305"
},
"createdAt": "2026-02-16T16:37:39.412Z",
"updatedAt": "2026-04-10T14:12:13.144Z",
"archived": false,
"url": "https://app.hubspot.com/contacts/5310426/record/0-3/56383560305"
}
The owner ID property and relatonsship to outher user IDs is discussed extensively elsewhere in this community - but as you say, translation of the owner ID to a name will require an additional step. I actually use a workflow step to extract a derived value.
I hope this is helpful.
Steve
Hi Steve,
Thanks again for the response.
Apologies in advance - I’m a bit new to all of this. I don’t see yet how this relates to my question. I see you are incorporating contacts and deal ids into the API call? Are you able to explain this a bit better? (I’m a newbie).
What I’m trying to do is get all deals with their respective amounts, descriptions, dates and statuses. I’m using variations of https://api.hubapi.com/crm/v3/objects/0-3/2336215336?properties={properties} but it’s not returning description.
Hi Steve - I just discovered that for records without a description, it doesn’t return anything. I was expecting at least a blank column, but that’s not the case. I queried a record with a description and it came through…so it looks like I just need to do some more digging/exploration. : )
Thanks again for your help.
@BTaylor16 - Strictly speaking, the returned information from the request (where you ask for the description property) always includes the requested ‘description’ element in the JSON structure, but the value of this property is returned as null if there is no description set.
Steve