# Dimensions Object Values Don't Match Documentation

**URL:** <https://community.shiphero.com/t/dimensions-object-values-dont-match-documentation/635>\
**Category:** GraphQL API\
**Created:** [August 4, 2020, 9:47pm UTC](https://community.shiphero.com/t/dimensions-object-values-dont-match-documentation/635 "2020-08-04T21:47:38Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![brett](https://sea2.discourse-cdn.com/flex020/user_avatar/community.shiphero.com/brett/32/140_2.png) [@brett](https://community.shiphero.com/u/brett)\
**Post date:** [August 4, 2020, 9:47pm UTC](https://community.shiphero.com/t/dimensions-object-values-dont-match-documentation/635/1 "2020-08-04T21:47:39Z")

</div>

While working to parse shipment data out of ShipHero, the documentation states that the “Dimensions” object’s “weight” property is to be expressed in ounces (oz):

 ![image](https://us1.discourse-cdn.com/flex020/uploads/shiphero/original/1X/f3199bd9743957e46c72dac8b915d3a0df9e3873.png)

While yes, the resulting value is a string, it’s not expressed in ounces and it contains a label that isn’t “oz”:  
 ![image](https://us1.discourse-cdn.com/flex020/uploads/shiphero/original/1X/7405855df820be94211f6c7fd5b7c4144300f190.png)

I had to manually go and validate that the numerical value in the response is actually being express in pounds and the weight of the shipped item really was only 3 ounces.

Is the documentation wrong, or is the API response wrong?

As a follow-up: Is there a reason why you’re not just exposing two varieties of each property (one metric, one imperial)? For example:

```
"dimensions": {
  "weight_lb": 0.1500,
  "weight_kg": 0.0682,
  "width_in": 12.0000,
  "width_cm": 30.4800
}

```

This way it’s easier to work with the dimensions object and there’s clarity upon the units used for the value.

---

<div class="post-metadata">

**Author:** ![tomasw](https://sea2.discourse-cdn.com/flex020/user_avatar/community.shiphero.com/tomasw/32/248_2.png) [@tomasw](https://community.shiphero.com/u/tomasw)\
**Post date:** [August 5, 2020, 1:44pm UTC](https://community.shiphero.com/t/dimensions-object-values-dont-match-documentation/635/2 "2020-08-05T13:44:33Z")

</div>

Hi @brett  
Input dimensions are considered to be in the [account’s settings unit](https://app.shiphero.com/dashboard/settings/app) unless specified by the field name like `weight_in_lbs`  
Output dimensions will always be in the [account’s settings unit](https://app.shiphero.com/dashboard/settings/app) unless specified by the field name like `weight_in_lbs`  
By default, accounts are set to oz, that is probably why the schema shows oz, I will request for that to be omitted.  
Let me know if this still doesn’t help  
Thanks!  
Tom

---

<div class="post-metadata">

**Author:** ![brett](https://sea2.discourse-cdn.com/flex020/user_avatar/community.shiphero.com/brett/32/140_2.png) [@brett](https://community.shiphero.com/u/brett)\
**Post date:** [August 5, 2020, 3:26pm UTC](https://community.shiphero.com/t/dimensions-object-values-dont-match-documentation/635/3 "2020-08-05T15:26:31Z")

</div>

I understand that the values are based upon settings in the UI (after seeing another comment on here about that). Can we add a unit-specific field to the `Dimensions` object? Either (or both) `weight_in_oz` and `weight_in_lb`? This would be much easier to work with when reading and would reduce the possibility of integrations breaking if the UI settings were changed later.

---

<div class="post-metadata">

**Author:** ![brett](https://sea2.discourse-cdn.com/flex020/user_avatar/community.shiphero.com/brett/32/140_2.png) [@brett](https://community.shiphero.com/u/brett)\
**Post date:** [August 7, 2020, 1:37pm UTC](https://community.shiphero.com/t/dimensions-object-values-dont-match-documentation/635/4 "2020-08-07T13:37:00Z")

</div>

@tomasw Just following up on my last comment. Just looking for an answer if we’ll see these unit-specific versions of properties in the `Dimensions` object in the future.

---

<div class="post-metadata">

**Author:** ![tomasw](https://sea2.discourse-cdn.com/flex020/user_avatar/community.shiphero.com/tomasw/32/248_2.png) [@tomasw](https://community.shiphero.com/u/tomasw)\
**Post date:** [August 7, 2020, 2:08pm UTC](https://community.shiphero.com/t/dimensions-object-values-dont-match-documentation/635/5 "2020-08-07T14:08:51Z")

</div>

Hi @brett !  
I apologize for the delay in my update.  
Thanks for the description, I see what you mean. I made a Feature Request for this, so I will let you know as soon as I have a response about it  
Thanks for the patience!  
Tom

---

<div class="post-metadata">

**Author:** ![tomasw](https://sea2.discourse-cdn.com/flex020/user_avatar/community.shiphero.com/tomasw/32/248_2.png) [@tomasw](https://community.shiphero.com/u/tomasw)\
**Post date:** [August 11, 2020, 12:20am UTC](https://community.shiphero.com/t/dimensions-object-values-dont-match-documentation/635/6 "2020-08-11T00:20:10Z")

</div>

Hi @brett  
Unfortunately we won’t be able to work on this at the moment. It will keep working in the account units.  
I will keep it in my notes in case it comes up again, but due to the work we are already making on the Public API we won’t be able to take this task at the moment.  
Again I apologize and don’t hesitate to reach out if there is anything else I could help you with.  
Thanks for the patience!  
Tom
