# Property default\_unit\_cost is not documented and is missing in .NET SDK **URL:** \ **Category:** Questions\ **Tags:** catalog-api, sdk\ **Created:** [February 21, 2025, 2:02pm UTC](https://developer.squareup.com/forums/t/property-default-unit-cost-is-not-documented-and-is-missing-in-net-sdk/21150 "2025-02-21T14:02:55Z")\ **Posts on this page:** 8\ **Page:** 1
**Author:** ![alexey\_ladera](https://avatars.discourse-cdn.com/v4/letter/a/c57346/32.png) [@alexey\_ladera](https://developer.squareup.com/forums/u/alexey_ladera)\ **Post date:** [February 21, 2025, 2:02pm UTC](https://developer.squareup.com/forums/t/property-default-unit-cost-is-not-documented-and-is-missing-in-net-sdk/21150/1 "2025-02-21T14:02:56Z")
When I pull item and item variation objects using catalog API in the sandbox, the response has object item\_variation\_data with nested objects price\_money and default\_unit\_cost. However, the latter does not appear in the API reference and is also missing in [.NET SDK](https://github.com/square/square-dotnet-sdk) which I use in my application. Is it some new property? Are there plans to add it to SDK and documentation? ![default_unit_cost](https://global.discourse-cdn.com/square/original/2X/b/b7eff13152c32ca7c367901692de2b79ba365dcb.png) ---
**Author:** ![Square-Dev-AI](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/square-dev-ai/32/2513_2.png) [@Square-Dev-AI](https://developer.squareup.com/forums/u/Square-Dev-AI)\ **Post date:** [February 21, 2025, 2:03pm UTC](https://developer.squareup.com/forums/t/property-default-unit-cost-is-not-documented-and-is-missing-in-net-sdk/21150/2 "2025-02-21T14:03:14Z")
👋 I’m Square Dev AI, here to help answer your question! Based on the information you’ve provided, the following documentation will help answer your question: > **[Design a Catalog](https://developer.squareup.com/docs/catalog-api/design-a-catalog)** > > When designing a product catalog, learn where to draw the line between an item, item variation, and item modifier. > **[Catalog API](https://developer.squareup.com/docs/catalog-api/what-it-does)** > > Learn about creating and managing a product catalog with the Square Catalog API. > **Additional Documentation** > > [Define Item Variations Using Options](https://developer.squareup.com/docs/catalog-api/item-options-migration) > [Orders API: How It Works](https://developer.squareup.com/docs/orders-api/how-it-works) > [Monitor Sold-out Item Variations or Modifiers](https://developer.squareup.com/docs/inventory-api/monitor-sold-out-status-on-item-variation) If this documentation helped you find a solution, please check the box indicating that this reply solves the problem. Otherwise one of our Developer Advocates will provide additional assistance shortly. ---
**Author:** ![Square-Dev-AI](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/square-dev-ai/32/2513_2.png) [@Square-Dev-AI](https://developer.squareup.com/forums/u/Square-Dev-AI)\ **Post date:** [February 21, 2025, 5:03pm UTC](https://developer.squareup.com/forums/t/property-default-unit-cost-is-not-documented-and-is-missing-in-net-sdk/21150/3 "2025-02-21T17:03:48Z")
The `default_unit_cost` field you’re seeing in the response is not officially part of the Square API. It’s likely an internal field used by Square and is not intended for external use. As such, it’s not included in the official API documentation or SDKs. It’s recommended to not rely on this field in your application, as its behavior may change without notice. Instead, you should use the officially documented fields and methods for managing item costs and prices. _This answer was reviewed by @Bryan-Square._ ---
**Author:** ![alexey\_ladera](https://avatars.discourse-cdn.com/v4/letter/a/c57346/32.png) [@alexey\_ladera](https://developer.squareup.com/forums/u/alexey_ladera)\ **Post date:** [March 11, 2025, 1:14am UTC](https://developer.squareup.com/forums/t/property-default-unit-cost-is-not-documented-and-is-missing-in-net-sdk/21150/4 "2025-03-11T01:14:53Z")
I’m seeing `default_unit_cost` in production API responses as well for some of the merchants I’m building an app for. So it looks like people do set it for their catalog items. Do you have any information if this field is going to be officially supported by API anytime soon? ---
**Author:** ![Bryan-Square](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/bryan-square/32/38_2.png) [@Bryan-Square](https://developer.squareup.com/forums/u/Bryan-Square)\ **Post date:** [March 11, 2025, 4:30pm UTC](https://developer.squareup.com/forums/t/property-default-unit-cost-is-not-documented-and-is-missing-in-net-sdk/21150/5 "2025-03-11T16:30:41Z")
At this time I don’t have any public roadmaps for the undocumented field. 🙂 ---
**Author:** ![jhardin\_accumula](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/jhardin_accumula/32/9412_2.png) [@jhardin\_accumula](https://developer.squareup.com/forums/u/jhardin_accumula)\ **Post date:** [July 2, 2025, 12:03am UTC](https://developer.squareup.com/forums/t/property-default-unit-cost-is-not-documented-and-is-missing-in-net-sdk/21150/6 "2025-07-02T00:03:46Z")
> [@Square-Dev-AI](#): > > Instead, you should use the officially documented fields and methods for managing item costs… @Bryan-Square: What _ **is** _ the “officially documented” way to use the API to retrieve COGS and vendor information (vendor ID, vendor product code) for merchandise in Square when the merchant is using the Square-native mechanisms to enter and track that information? I am querying data from a client’s production account and I don’t see any catalogobject custom attributes defined that look promising. ---
**Author:** ![josh-square](https://avatars.discourse-cdn.com/v4/letter/j/77aa72/32.png) [@josh-square](https://developer.squareup.com/forums/u/josh-square)\ **Post date:** [July 2, 2025, 5:40pm UTC](https://developer.squareup.com/forums/t/property-default-unit-cost-is-not-documented-and-is-missing-in-net-sdk/21150/7 "2025-07-02T17:40:39Z")
@jhardin_accumula I think the way that response was constructed is a bit misleading. There’s no official support for COGS with the API right no, sorry for the confusion! ---
**Author:** ![jhardin\_accumula](https://sea1.discourse-cdn.com/square/forums/user_avatar/developer.squareup.com/jhardin_accumula/32/9412_2.png) [@jhardin\_accumula](https://developer.squareup.com/forums/u/jhardin_accumula)\ **Post date:** [July 2, 2025, 5:55pm UTC](https://developer.squareup.com/forums/t/property-default-unit-cost-is-not-documented-and-is-missing-in-net-sdk/21150/8 "2025-07-02T17:55:13Z")
Okay, thank you for clarifying.