# Response The response for the Package Dimension operation provides detailed logistics and product data in a structured JSON format. This output is designed for easy parsing and integration into FBA auditing tools, logistics dashboards, and cost analysis workflows. ## API Response Structure Overview Every successful response follows a consistent architecture, organized into four primary objects: 1. **`request_info:`** Contains the status of the API call and credit consumption details. 2. **`request_parameters:`** Confirms the parameters sent in the request. 3. **`request_metadata:`** Provides processing timestamps and performance metrics. 4. **`result:`** The core section containing the package dimensions, weight, and product data. ## 1. Top Level Meta Fields (Outside of result) These fields provide essential information about the transaction status, parameters, and processing timing. ### request\_info (object) The `request_info` object provides the technical status of your API call and real-time updates on your credit usage. It is the primary reference for debugging and monitoring your account's consumption limits. | Field | Type | Description | | ------------------------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | **`id`** | String | A unique transaction identifier assigned to the request. This ID is essential for tracking operations and should be provided when contacting support. | | **`success`** | Boolean | Indicates whether the request was successfully processed by the system. | | **`status_code`** | Integer | The standard HTTP status code returned for the operation (e.g., 200 for success). | | **`error_details`** | Array | Contains a list of error messages or codes if the request fails or encounters issues. | | **`credits_used`** | Integer | The total cumulative number of credits consumed by your account during the current period or session. | | **`credit_used_this_request`** | Integer | The specific number of credits consumed by this individual operation (BSR typically consumes 1 credit). | | **`credits_remaining`** | Integer | Your current remaining credit balance available for future requests. | | **`credits_reset_at`** | String | The timestamp indicating when your credit quota is scheduled to reset (ISO 8601 format). | ### request\_metadata (Object) The `request_metadata` object captures performance-related metrics and timestamps throughout the lifecycle of the request. These details help you evaluate system latency and data freshness. | Field | Type | Description | | ---------------------- | ------ | ----------------------------------------------- | | **`created_at`** | String | The timestamp when the request was received. | | **`processed_at`** | String | The timestamp when processing was completed. | | **`total_time_taken`** | Float | The total duration of the operation in seconds. | ### request\_parameters (Object) The `request_parameters` object serves as an echo of the input values you provided in your request. This allows for programmatic verification that the correct parameters were used to generate the response. | Field | Type | Description | | ---------- | ------ | -------------------------------------------------- | | **`asin`** | String | The ASIN used for the query. | | **`type`** | String | The operation type executed (`PACKAGE_DIMENSION`). | ## 2. Core Payload (Inside result) The result object contains the primary logistics and product information. ### package (Object) Contains the physical attributes of the packaged product. ### package.dimensions (Object) The `dimensions` object provides the exact physical measurements of the product's packaging. This data is essential for determining dimensional weight, shipping tier classifications, and storage space requirements in fulfillment centers. | Field | Type | Description | TextExample | | -------------------- | ------ | --------------------------------------------------------------- | --------------------------------------- | | **`height`** | Float | The vertical measurement of the package. | 33.12 | | **`length`** | Float | The longest horizontal side of the package. | 8 | | **`width`** | Float | The shorter horizontal side of the package. | 20 | | **`unit`** | String | The standard unit of measurement used for the dimensions. | "inches" | | **`unit_string_id`** | String | An internal Amazon-specific identifier for the unit of measure. | "SC\_FBA\_UnitOfMeasure\_Inches\_39146" | ### package.weight (Object) The `weight` object specifies the total mass of the packaged product. This is a primary factor in calculating shipping costs and weight-based surcharges across various logistics providers. | Field | Type | Description | Example | | ----------- | ------ | --------------------------------------------- | -------- | | **`value`** | Float | The numerical mass or weight of the package. | 31.1491 | | **`unit`** | String | The unit of measurement for the weight value. | "pounds" | ### product (Object) The `product` object serves as the central container for the commercial identity of the ASIN. While the `package` object focuses on physical logistics, the `product` object provides the marketplace context, including pricing, branding, and category classification. | Field | Type | Description | Example | | ------------------ | ------ | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- | | **`asin`** | String | The unique 10-character identifier for the product on Amazon. | "B0DBB63XGC" | | **`title`** | String | The full, official name of the product as it appears on the live listing. | "BenQ MA270U..." | | **`brand`** | String | The manufacturer or brand name associated with the product. | "BenQ" | | **`fee_category`** | String | The specific Amazon category used to calculate FBA and referral fees. | "BASE\_PRODUCT" | | **`gl`** | String | General Ledger code representing the broader product group for logistical sorting. | "gl\_pc" | | **`link`** | String | The canonical URL leading directly to the product detail page. | "..." | | `dimensions` | Object | The physical measurements of the actual item (unboxed). | [See breakdown below](#product.dimensions-object) | | `weight` | Object | The weight of the individual item without shipping materials. | [See breakdown below](#product.weight-object) | | `media` | Object | It consolidates the visual assets of the product, providing direct links to the images used on the Amazon listing | [See breakdown below](#product.media-object) | ### product.dimensions (Object) The `product.dimensions` object provides the three-dimensional footprint of the actual item itself, excluding any shipping boxes, mailers, or protective outer packaging. These values represent the physical size of the product as it would be encountered by the end-user or displayed on a shelf.
FieldTypeDescriptionExample
heightFloatThe vertical measurement of the standalone product.17.25
lengthFloatThe longest horizontal side of the product.0.75
widthFloatThe shorter horizontal side of the product.5.75
unitStringThe standard unit of measurement (e.g., inches, cm) for the product size.inches
### product.weight (Object) The `product.weight` object specifies the mass of the individual item without its shipping materials. This is the net weight of the product, which is essential for technical specifications and understanding the actual weight of the goods being sold. | value | Float | The numerical mass or net weight of the product. | `1.1` | | ----- | ------ | ------------------------------------------------------------------ | -------- | | unit | String | The unit of measurement (e.g., pounds, kg) for the product weight. | `pounds` | ### product.media (Object) The `media` object is a specialized sub-module nested within the `product` container. It consolidates the visual assets of the product, providing direct links to the images used on the Amazon listing. This separation allows developers to easily isolate UI elements from the textual metadata. | Field | Type | Description | Example | | --------------- | ------ | ------------------------------------------------------------------------------ | -------------------------------------------------------------------- | | **`image`** | String | The URL of the high-resolution primary product image. | "" | | **`thumbnail`** | String | The URL of the optimized, smaller version of the primary image for list views. | "" | ## 3. Standalone Result Fields The root of the `result` object contains high-level identifiers that define the geographical context of the operation. These fields exist independently of the specialized `package` and `product` objects to provide a quick reference for the data's origin. **`country_code`**`:` The ISO alpha-2 country code of the Amazon marketplace where the data was retrieved (e.g., "US"). ## Sample JSON Output ```json { "request_info":{ "id":"302677a1-6616-4129-82fc-d9fb8e7a5747", "success":true, "status_code":200, "error_details":[ ], "credits_used":1, "credit_used_this_request":1, "credits_remaining":99, "credits_reset_at":"2026-04-09T07:41:48.000Z" }, "request_parameters":{ "asin":"B004N627KS", "type":"PACKAGE_DIMENSION" }, "request_metadata":{ "created_at":"2026-03-18T00:29:06.022Z", "processed_at":"2026-03-18T00:29:09.248Z", "total_time_taken":3.226 }, "result":{ "country_code":"US", "package":{ "dimensions":{ "height":2.4799999974704, "length":20.041923056480318, "unit":"inches", "width":9.5299999902794 }, "weight":{ "unit":"pounds", "value":1.7196056436 } }, "product":{ "asin":"B004N627KS", "brand":"Logitech", "dimensions":{ "height":17.25, "length":0.75, "unit":"inches", "width":5.75 }, "fee_category":"BASE_PRODUCT", "gl":"ce_display_on_website", "link":"https://www.amazon..com/dp/B004N627KS", "main_image":{ "id":"61FxW-B6tgL", "link":"https://m.media-amazon.com/images/I/61FxW-B6tgL.jpg" }, "media":{ "image":"https://m.media-amazon.com/images/I/61FxW-B6tgL.jpg", "thumbnail":"https://m.media-amazon.com/images/I/41+R7pH+2RL._SL75_.jpg" }, "thumb_image":{ "id":"41+R7pH+2RL", "link":"https://m.media-amazon.com/images/I/41+R7pH+2RL._SL75_.jpg" }, "title":"Logitech K270 Wireless Keyboard for Windows, 2.4 GHz Wireless, Full-Size, Number Pad, 8 Multimedia Keys, 2-Year Battery Life, Compatible with PC, Laptop, Black", "weight":{ "unit":"pounds", "value":1.1 } } } } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://easyparser.gitbook.io/easyparser-documentation/real-time-integration/package-dimension/response.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.