---
updatedAt: 2026-04-17T03:23:37.000Z
agentTools:
  projectIndex: https://api-docs.shippedsuite.com/llms.txt
---

# /v1/rmas/{number}

Returns a specific RMA

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Shipped Suite API",
    "description": "API provides access to Shipped Suite functions",
    "contact": {
      "name": "Steven Ou",
      "email": "steven@invisiblecommerce.com"
    },
    "version": "v1"
  },
  "servers": [
    {
      "url": "//api.shippedsuite.com/"
    }
  ],
  "security": [
    {
      "secretKey": []
    }
  ],
  "tags": [
    {
      "name": "RMAs",
      "description": "Operations about RMAs"
    }
  ],
  "paths": {
    "/v1/rmas/{number}": {
      "get": {
        "tags": [
          "RMAs"
        ],
        "description": "Returns a specific RMA",
        "operationId": "getV1RmasNumber",
        "parameters": [
          {
            "name": "number",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a specific RMA",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Rma"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Order": {
        "required": [
          "canceled_at",
          "carbon_credits",
          "carbon_offset",
          "claims",
          "customer",
          "email",
          "external_id",
          "fulfillment_status",
          "number",
          "order_adjustments",
          "order_items",
          "payment_status",
          "placed_at",
          "shield",
          "shipments",
          "shipped_id",
          "shipping_address",
          "taxes_included",
          "transactions"
        ],
        "type": "object",
        "properties": {
          "number": {
            "type": "string",
            "description": "Unique Order number",
            "example": "EEF-444323"
          },
          "shipped_id": {
            "type": "string",
            "description": "Globally-unique Shipped order ID",
            "example": "015DBC4801F2547DA2E6"
          },
          "email": {
            "type": "string",
            "description": "The email address associated with the Order",
            "example": "john.doe@shopper.com"
          },
          "external_id": {
            "type": "string",
            "description": "Unique ID of Order in partner platform",
            "example": "12443"
          },
          "placed_at": {
            "type": "string",
            "description": "Date and time the order was placed. RFC 3339.",
            "format": "date-time"
          },
          "canceled_at": {
            "type": "string",
            "description": "Date and time the order was canceled. RFC 3339.",
            "format": "date-time"
          },
          "payment_status": {
            "type": "string",
            "description": "The payment status of the Order",
            "example": "paid",
            "enum": [
              "authorized",
              "voided",
              "paid",
              "partially_paid",
              "refunded",
              "partially_refunded",
              "pending"
            ]
          },
          "fulfillment_status": {
            "type": "string",
            "description": "The fulfillment status of the Order",
            "example": "fulfilled",
            "enum": [
              "fulfilled",
              "in_progress",
              "on_hold",
              "open",
              "partially_fulfilled",
              "pending_fulfillment",
              "request_declined",
              "restocked",
              "scheduled",
              "unfulfilled"
            ]
          },
          "shield": {
            "type": "object",
            "description": "Shipped Shield details, if order is protected by Shipped Shield.",
            "allOf": [
              {
                "$ref": "#/components/schemas/Shield"
              }
            ]
          },
          "carbon_offset": {
            "type": "object",
            "description": "Shipped Green details, if order has Shipped Green carbon offset.",
            "allOf": [
              {
                "$ref": "#/components/schemas/CarbonOffset"
              }
            ]
          },
          "taxes_included": {
            "type": "boolean",
            "description": "Whether or not prices already include taxes"
          },
          "customer": {
            "type": "object",
            "description": "The Customer who placed the Order",
            "allOf": [
              {
                "$ref": "#/components/schemas/Customer"
              }
            ]
          },
          "shipping_address": {
            "type": "object",
            "description": "Shipping address for the Order",
            "allOf": [
              {
                "$ref": "#/components/schemas/ShippingAddress"
              }
            ]
          },
          "order_items": {
            "type": "array",
            "description": "Collection of OrderItems belonging to the Order",
            "items": {
              "$ref": "#/components/schemas/OrderItem"
            }
          },
          "order_adjustments": {
            "type": "array",
            "description": "Collection of OrderAdjustments belonging to the Order",
            "items": {
              "$ref": "#/components/schemas/OrderAdjustment"
            }
          },
          "shipments": {
            "type": "array",
            "description": "Collection of Shipments associated with the Order",
            "items": {
              "$ref": "#/components/schemas/Shipment"
            }
          },
          "transactions": {
            "type": "array",
            "description": "Collection of Transactions associated with the Order",
            "items": {
              "$ref": "#/components/schemas/Transaction"
            }
          },
          "claims": {
            "type": "array",
            "description": "Collection of Claims associated with the Order",
            "items": {
              "$ref": "#/components/schemas/Claim"
            }
          },
          "carbon_credits": {
            "type": "array",
            "description": "Collection of CarbonCredits associated with the Order",
            "items": {
              "$ref": "#/components/schemas/CarbonCredit"
            }
          }
        },
        "description": "Order model"
      },
      "Shield": {
        "required": [
          "display_fee",
          "fee",
          "payer_type"
        ],
        "type": "object",
        "properties": {
          "fee": {
            "type": "number",
            "description": "Shield fee for this Order in the storefront currency",
            "example": 0.97
          },
          "display_fee": {
            "type": "object",
            "description": "Shield fee for this order in the display currency",
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ]
          },
          "payer_type": {
            "type": "string",
            "description": "Party responsible for payment",
            "example": "customer"
          }
        }
      },
      "Money": {
        "required": [
          "currency",
          "formatted",
          "subunits"
        ],
        "type": "object",
        "properties": {
          "currency": {
            "type": "object",
            "description": "Currency",
            "allOf": [
              {
                "$ref": "#/components/schemas/Currency"
              }
            ]
          },
          "subunits": {
            "type": "integer",
            "description": "The value in the currency's smallest unit",
            "format": "int32",
            "example": 4000
          },
          "formatted": {
            "type": "string",
            "description": "Formatted representation",
            "example": "€40,00"
          }
        }
      },
      "Currency": {
        "required": [
          "decimal_mark",
          "iso_code",
          "name",
          "subunit_to_unit",
          "symbol",
          "symbol_first",
          "thousands_separator"
        ],
        "type": "object",
        "properties": {
          "decimal_mark": {
            "type": "string",
            "description": "Symbol use to separate decimals",
            "example": "."
          },
          "symbol": {
            "type": "number",
            "description": "Currency symbol"
          },
          "symbol_first": {
            "type": "boolean",
            "description": "Whether to display the symbol before or after the number",
            "example": true
          },
          "thousands_separator": {
            "type": "string",
            "description": "Symbol used to separate each thousand units",
            "example": ","
          },
          "subunit_to_unit": {
            "type": "integer",
            "description": "The number of subunits to a unit",
            "format": "int32",
            "example": 100
          },
          "iso_code": {
            "type": "string",
            "description": "The ISO code for the Currency",
            "example": "USD"
          },
          "name": {
            "type": "string",
            "description": "The full name of the Currency",
            "example": "USD"
          }
        },
        "description": "Currency model"
      },
      "CarbonOffset": {
        "required": [
          "display_fee",
          "fee",
          "payer_type"
        ],
        "type": "object",
        "properties": {
          "fee": {
            "type": "number",
            "description": "Green fee for this Order in the storefront currency",
            "example": 0.97
          },
          "display_fee": {
            "type": "object",
            "description": "Green fee for this order in the display currency",
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ]
          },
          "payer_type": {
            "type": "string",
            "description": "Party responsible for payment",
            "example": "customer"
          }
        }
      },
      "Customer": {
        "required": [
          "accepts_email_marketing",
          "accepts_sms_marketing",
          "email",
          "external_id",
          "first_name",
          "last_name"
        ],
        "type": "object",
        "properties": {
          "external_id": {
            "type": "string",
            "description": "Unique ID of Customer in partner platform",
            "example": "765002848"
          },
          "first_name": {
            "type": "string",
            "description": "First name of Customer",
            "example": "John"
          },
          "last_name": {
            "type": "string",
            "description": "Last name of Customer",
            "example": "Doe"
          },
          "email": {
            "type": "string",
            "description": "Email address of Customer",
            "example": "john.doe@shopper.com"
          },
          "phone": {
            "type": "string",
            "description": "Phone number of Customer",
            "example": "+1800APLCARE"
          },
          "notes": {
            "type": "string",
            "description": "Notes associated with the Customer",
            "example": "This customer is the #1 VIP!"
          },
          "accepts_email_marketing": {
            "type": "boolean",
            "description": "Whether or not Customer accepts email marketing",
            "example": true
          },
          "accepts_sms_marketing": {
            "type": "boolean",
            "description": "Whether or not Customer accepts SMS marketing",
            "example": false
          }
        },
        "description": "Customer model"
      },
      "ShippingAddress": {
        "required": [
          "address1",
          "city",
          "country",
          "state",
          "zip"
        ],
        "type": "object",
        "properties": {
          "first_name": {
            "type": "string",
            "description": "First name",
            "example": "John"
          },
          "last_name": {
            "type": "string",
            "description": "Last name",
            "example": "Doe"
          },
          "company": {
            "type": "string",
            "description": "Company name",
            "example": "Apple, Inc."
          },
          "address1": {
            "type": "string",
            "description": "Address line 1",
            "example": "One Apple Park Way"
          },
          "address2": {
            "type": "string",
            "description": "Address line 2"
          },
          "city": {
            "type": "string",
            "description": "City",
            "example": "Cupertino"
          },
          "state": {
            "type": "string",
            "description": "2 letter state code",
            "example": "CA"
          },
          "zip": {
            "type": "string",
            "description": "Zip/postal code",
            "example": "95014"
          },
          "country": {
            "type": "string",
            "description": "2-letter country code",
            "example": "US"
          },
          "phone": {
            "type": "string",
            "description": "Phone number",
            "example": "+1800APLCARE"
          }
        }
      },
      "OrderItem": {
        "required": [
          "description",
          "external_id",
          "external_product_id",
          "external_variant_id",
          "quantity",
          "subtotal",
          "tax",
          "unit_price"
        ],
        "type": "object",
        "properties": {
          "external_id": {
            "type": "string",
            "description": "Unique ID of OrderItem in partner platform",
            "example": "10312518631616"
          },
          "external_product_id": {
            "type": "string",
            "description": "Unique ID of OrderItem's Product in partner platform",
            "example": "6584397299904"
          },
          "external_variant_id": {
            "type": "string",
            "description": "Unique ID of OrderItem's Variant in partner platform",
            "example": "39432474722496"
          },
          "sku": {
            "type": "string",
            "description": "SKU of the OrderItem's Variant",
            "example": "DN4155-001"
          },
          "description": {
            "type": "string",
            "description": "Description of the OrderItem's Variant",
            "example": "Nike Air Max 90 SE (Size: 9)"
          },
          "quantity": {
            "type": "integer",
            "description": "Quantity of Variant in OrderItem",
            "format": "int32",
            "example": 2
          },
          "unit_price": {
            "type": "number",
            "description": "Unit price of OrderItem in storefront default currency",
            "example": 140
          },
          "discount": {
            "type": "number",
            "description": "Total discount applied to OrderItem (absolute value) in storefront default currency'\n",
            "example": 10
          },
          "tax": {
            "type": "number",
            "description": "Total tax applicable to OrderItem in storefront default currency",
            "example": 12.25
          },
          "subtotal": {
            "type": "number",
            "description": "Quantity * unit_price (auto-calculated) in storefront default currency\n",
            "example": 280
          },
          "display_unit_price": {
            "type": "object",
            "description": "Unit price of OrderItem in the display currency (if different from default currency)\n",
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ]
          },
          "display_discount": {
            "type": "object",
            "description": "Total discount applied to OrderItem (absolute value) in the display currency (if different from default currency)\n",
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ]
          },
          "display_tax": {
            "type": "object",
            "description": "Total tax applicable to OrderItem in the display currency (if different from default currency)\n",
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ]
          },
          "display_subtotal": {
            "type": "object",
            "description": "Quantity * unit_price (auto-calculated) in the display currency (if different from default currency)\n",
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ]
          }
        }
      },
      "OrderAdjustment": {
        "required": [
          "amount",
          "category",
          "description",
          "external_id",
          "tax"
        ],
        "type": "object",
        "properties": {
          "external_id": {
            "type": "string",
            "description": "Unique ID of OrderAdjustment in partner platform",
            "example": "98790909347544"
          },
          "category": {
            "type": "string",
            "description": "The type of OrderAdjustment",
            "example": "shipping",
            "enum": [
              "shipping",
              "discount",
              "tip"
            ]
          },
          "description": {
            "type": "string",
            "description": "Description of the OrderAdjustment",
            "example": "Priority (1-3 business days)"
          },
          "amount": {
            "type": "number",
            "description": "Value of the OrderAdjustment in the storefront default currency",
            "example": 15
          },
          "discount": {
            "type": "number",
            "description": "Total discount applied to OrderAdjustment (absolute value) in the storefront default currency\n",
            "example": 5
          },
          "tax": {
            "type": "number",
            "description": "Total tax applicable to OrderAdjustment in the storefront default currency\n",
            "example": 1.29
          },
          "display_amount": {
            "type": "object",
            "description": "Value of the OrderAdjustment in the display currency (if different from default currency)\n",
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ]
          },
          "display_discount": {
            "type": "object",
            "description": "Total discount applied to OrderAdjustment (absolute value) in the display currency (if different from default currency)\n",
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ]
          },
          "display_tax": {
            "type": "object",
            "description": "Total tax applicable to OrderAdjustment in the display currency (if different from default currency)\n",
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ]
          }
        }
      },
      "Shipment": {
        "required": [
          "external_id",
          "shipment_items",
          "tracking_number"
        ],
        "type": "object",
        "properties": {
          "external_id": {
            "type": "string",
            "description": "Unique ID of Shipment in partner platform",
            "example": "9477990309572"
          },
          "tracking_number": {
            "type": "string",
            "description": "Tracking number associated with the Shipment",
            "example": "1Z71E8390396779841"
          },
          "shipment_items": {
            "type": "array",
            "description": "Collection of ShipmentItems belonging to the Shipment",
            "items": {
              "$ref": "#/components/schemas/ShipmentItem"
            }
          }
        },
        "description": "Shipment model"
      },
      "ShipmentItem": {
        "required": [
          "external_id",
          "external_order_item_id",
          "quantity"
        ],
        "type": "object",
        "properties": {
          "external_id": {
            "type": "string",
            "description": "Unique ID of ShipmentItem in partner platform",
            "example": "769209090444"
          },
          "external_order_item_id": {
            "type": "string",
            "description": "Unique ID of ShipmentItem's OrderItem in partner platform",
            "example": "10312518631616"
          },
          "quantity": {
            "type": "integer",
            "description": "Quantity of OrderItem in ShipmentItem",
            "format": "int32",
            "example": 1
          }
        }
      },
      "Transaction": {
        "required": [
          "amount",
          "category",
          "currency",
          "external_id",
          "processed_at",
          "status"
        ],
        "type": "object",
        "properties": {
          "external_id": {
            "type": "string",
            "description": "Unique ID of Transaction in partner platform",
            "example": "432679798"
          },
          "gateway": {
            "type": "string",
            "description": "Transaction gateway",
            "example": "paypal"
          },
          "gateway_id": {
            "type": "string",
            "description": "Gateway's transaction ID",
            "example": "8LL53699CW401930U"
          },
          "category": {
            "type": "string",
            "description": "The type of transaction",
            "example": "sale",
            "enum": [
              "sale",
              "refund"
            ]
          },
          "currency": {
            "type": "string",
            "description": "Currency of the transaction",
            "example": "USD"
          },
          "amount": {
            "type": "number",
            "description": "Amount of transaction (absolute value)",
            "example": 173.98
          },
          "status": {
            "type": "number",
            "description": "Status of the transaction"
          },
          "processed_at": {
            "type": "string",
            "description": "Date and time the transaction was processed. RFC 3339.",
            "format": "date-time"
          }
        }
      },
      "Claim": {
        "required": [
          "claim_items",
          "final_resolution_type",
          "number",
          "reason",
          "rejection_reason",
          "resolution_type",
          "resolved_at",
          "shipment",
          "status"
        ],
        "type": "object",
        "properties": {
          "number": {
            "type": "string",
            "description": "Unique Claim number",
            "example": "EEF-444323"
          },
          "reason": {
            "type": "string",
            "description": "The reason the Customer field a Claim",
            "example": "lost"
          },
          "note": {
            "type": "string",
            "description": "Additional notes provided by Customer regarding Claim",
            "example": "I have not received any tracking updates from FedEx for 2 weeks"
          },
          "status": {
            "type": "string",
            "description": "The current state of the Claim",
            "example": "approved",
            "enum": [
              "submitted",
              "need_more_information",
              "rejected",
              "approved",
              "invalidated"
            ]
          },
          "resolution_type": {
            "type": "string",
            "description": "Preferred type of resolution",
            "example": "replacement",
            "enum": [
              "manual",
              "refund",
              "store_credit",
              "replacement"
            ]
          },
          "rejection_reason": {
            "type": "string",
            "description": "The reason the Claim was rejected (if in rejected status)",
            "example": "Customer lied to us as proven by his own signature"
          },
          "final_resolution_type": {
            "type": "string",
            "description": "Type of resolution approved for this Claim",
            "example": "refund"
          },
          "resolved_at": {
            "type": "string",
            "description": "Date and time the Claim was approved or rejected. RFC 3339.",
            "format": "date-time"
          },
          "shipment": {
            "type": "object",
            "description": "Shipment the Claim is for",
            "allOf": [
              {
                "$ref": "#/components/schemas/Shipment"
              }
            ]
          },
          "claim_items": {
            "type": "array",
            "description": "Collection of ClaimItems belonging to the Order",
            "items": {
              "$ref": "#/components/schemas/ClaimItem"
            }
          }
        },
        "description": "Claim model"
      },
      "ClaimItem": {
        "required": [
          "order_item",
          "quantity"
        ],
        "type": "object",
        "properties": {
          "quantity": {
            "type": "integer",
            "description": "Quantity of OrderItem in ClaimItem",
            "format": "int32",
            "example": 2
          },
          "order_item": {
            "type": "array",
            "description": "OrderItem affected in this ClaimItem",
            "items": {
              "$ref": "#/components/schemas/OrderItem"
            }
          }
        }
      },
      "CarbonCredit": {
        "required": [
          "created_at",
          "id",
          "shipment"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique carbon credit ID"
          },
          "carbon_project": {
            "type": "object",
            "description": "Details about the Carbon Project in which the Carbon Credit was purchased",
            "allOf": [
              {
                "$ref": "#/components/schemas/CarbonProject"
              }
            ]
          },
          "status": {
            "type": "number",
            "description": "Current state of the Carbon Credit order"
          },
          "grams": {
            "type": "number",
            "description": "Number of grams of CO2 offset by Carbon Credit",
            "example": 456
          },
          "url": {
            "type": "string",
            "description": "Link to the receipt for the Carbon Credit",
            "example": "https://registry.patch.io/orders/ord_test_0eae4faf8ec48f01821a000d0d47d6b4"
          },
          "shipment": {
            "type": "object",
            "description": "Shipment the Carbon Credit was purchased for",
            "allOf": [
              {
                "$ref": "#/components/schemas/Shipment"
              }
            ]
          },
          "created_at": {
            "type": "string",
            "description": "The date and time the Carbon Credit order was initiated. RFC 3339. ",
            "format": "date-time"
          }
        },
        "description": "CarbonCredit model"
      },
      "CarbonProject": {
        "required": [
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "description": "ID for the CarbonProject",
            "example": 12
          },
          "name": {
            "type": "string",
            "description": "Name of the CarbonProject",
            "example": "China Hebei Province Wind Farm - Demo"
          },
          "tagline": {
            "type": "string",
            "description": "Tagline of the CarbonProject",
            "example": "Generating wind energy in Hebei Province and displacing fossil-fuel generated energy, improving local air quality."
          },
          "description": {
            "type": "string",
            "description": "Description of the CarbonProject",
            "example": "Hebei Kangbao Sanxiatian Wind Farm Project is located in Zhangjiakou City, Hebei Province, P.R.China. The wind farm contains 33 sets of turbines with a total installed capacity of 49.5 MW. Electricity generated by the project is delivered to the North China Power Grid (NCPG) and displaces power that would have been supplied by fossil-fuel fired power plants, thereby avoiding greenhouse gas emissions and other air pollutants, including SO2, NOx, and PM. The project is well-regarded by the local community and received strong stakeholder support during the construction phase in 2008. Operation of the wind farm commenced in 2009, and the project continues to improve air quality and boost tax revenues for the regional government."
          },
          "technology": {
            "type": "string",
            "description": "The type of technology of the CarbonProject",
            "example": "Wind"
          },
          "classification": {
            "type": "string",
            "description": "The classification of the CarbonProject strategy",
            "example": "avoidance"
          },
          "images": {
            "type": "array",
            "description": "An array of images for the CarbonProject",
            "example": [
              "https://cdn.patch.io/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcUVEIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--31c7e8944317bd244de66d3c070a44e804b8cd8e/Hebei%20Kangbao%20Sanxiatian%20Wind%20Farm%20Project_1.jpeg"
            ],
            "items": {
              "type": "string"
            }
          },
          "state": {
            "type": "string",
            "description": "The state/region/province CarbonProject is located in",
            "example": "HE"
          },
          "country": {
            "type": "string",
            "description": "The country CarbonProject is located in",
            "example": "CN"
          }
        }
      },
      "Rma": {
        "required": [
          "created_at",
          "number",
          "order",
          "resolution_trigger",
          "rma_items",
          "rma_shipment",
          "shipping_provider",
          "shipping_required",
          "status"
        ],
        "type": "object",
        "properties": {
          "number": {
            "type": "string",
            "description": "The unique identifier for the RMA",
            "example": "RTN6053474610"
          },
          "status": {
            "type": "string",
            "description": "The current status of the RMA",
            "example": "verified",
            "enum": [
              "authorized",
              "shipped",
              "received",
              "verified",
              "expired",
              "canceled",
              "error"
            ]
          },
          "shipping_required": {
            "type": "boolean",
            "description": "Whether the RMA requires the customer to ship the item back"
          },
          "resolution_trigger": {
            "type": "string",
            "description": "When the RMA resolutions are triggered",
            "example": "shipped",
            "enum": [
              "shipped",
              "received",
              "verified"
            ]
          },
          "shipping_provider": {
            "type": "string",
            "description": "The shipping provider for the RMA",
            "example": "fedex"
          },
          "order": {
            "type": "object",
            "description": "The Order the Return is associated with",
            "allOf": [
              {
                "$ref": "#/components/schemas/Order"
              }
            ]
          },
          "created_at": {
            "type": "string",
            "description": "The date and time the RMA was generated. RFC 3339. ",
            "format": "date-time"
          },
          "rma_items": {
            "type": "array",
            "description": "Collection of RMA Items associated with the RMA",
            "items": {
              "$ref": "#/components/schemas/RmaItem"
            }
          },
          "rma_shipment": {
            "type": "object",
            "description": "The RMA Shipment associated with the RMA",
            "allOf": [
              {
                "$ref": "#/components/schemas/RmaShipment"
              }
            ]
          }
        },
        "description": "Rma model"
      },
      "RmaItem": {
        "required": [
          "order_item",
          "quantity",
          "reason",
          "resolution_status",
          "resolution_type"
        ],
        "type": "object",
        "properties": {
          "quantity": {
            "type": "integer",
            "description": "Quantity of OrderItem in RMAItem",
            "format": "int32",
            "example": 2
          },
          "reason": {
            "type": "string",
            "description": "Reason for the RMAItem",
            "example": "defective"
          },
          "resolution_type": {
            "type": "string",
            "description": "Desired resolution for the RMAItem",
            "example": "refund"
          },
          "resolution_status": {
            "type": "string",
            "description": "Current status of the resolution for the RMAItem",
            "example": "pending"
          },
          "order_item": {
            "type": "array",
            "description": "OrderItem affected in this ClaimItem",
            "items": {
              "$ref": "#/components/schemas/OrderItem"
            }
          }
        }
      },
      "RmaShipment": {
        "required": [
          "courier",
          "created_at",
          "rma",
          "status",
          "tracking_number",
          "updated_at"
        ],
        "type": "object",
        "properties": {
          "courier": {
            "type": "object",
            "description": "Courier information",
            "allOf": [
              {
                "$ref": "#/components/schemas/Courier"
              }
            ]
          },
          "tracking_number": {
            "type": "string",
            "description": "Tracking number",
            "example": "282287874772"
          },
          "tracking_url": {
            "type": "string",
            "description": "URL for courier tracking page",
            "example": "https://www.fedex.com/fedextrack/?trknbr=282287874772"
          },
          "status": {
            "type": "string",
            "description": "Current tracking status",
            "example": "shipped",
            "enum": [
              "processing",
              "shipped",
              "out_for_delivery",
              "delivered",
              "exception"
            ]
          },
          "location": {
            "type": "string",
            "description": "Last known tracking location",
            "example": "SACRAMENTO, CA"
          },
          "estimated_delivery": {
            "type": "string",
            "description": "The estimated date and time the package will be delivered. RFC 3339. ",
            "format": "date-time"
          },
          "shipped_at": {
            "type": "string",
            "description": "The date and time the package was shipped. RFC 3339. ",
            "format": "date-time"
          },
          "delivered_at": {
            "type": "string",
            "description": "The date and time the package was delivered. RFC 3339. ",
            "format": "date-time"
          },
          "events": {
            "type": "object",
            "description": "Detailed tracking events",
            "allOf": [
              {
                "$ref": "#/components/schemas/TrackingEvent"
              }
            ]
          },
          "created_at": {
            "type": "string",
            "description": "The date and time the RMA Shipment was created. RFC 3339. ",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "description": "The date and time the RMA Shipment was last updated. RFC 3339. ",
            "format": "date-time"
          },
          "rma": {
            "type": "object",
            "description": "The RMA associated with the RMA Shipment",
            "allOf": [
              {
                "$ref": "#/components/schemas/RmaBasic"
              }
            ]
          }
        }
      },
      "Courier": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Courier name",
            "example": "FedEx"
          },
          "display_name": {
            "type": "string",
            "description": "Alternate courier display name",
            "example": "FedEx"
          },
          "phone": {
            "type": "string",
            "description": "Courier's phone number",
            "example": "1 800 463 3339"
          },
          "url": {
            "type": "string",
            "description": "Courier's website URL",
            "example": "https://www.fedex.com/"
          }
        }
      },
      "TrackingEvent": {
        "required": [
          "code",
          "message",
          "status",
          "sub_message",
          "time"
        ],
        "type": "object",
        "properties": {
          "time": {
            "type": "string",
            "description": "Time at which the Tracking Event occurred",
            "format": "date-time"
          },
          "status": {
            "type": "string",
            "description": "Tracking Event status",
            "example": "InTransit"
          },
          "message": {
            "type": "string",
            "description": "Tracking Event status message",
            "example": "Departed USPS Regional Facility"
          },
          "sub_message": {
            "type": "string",
            "description": "Tracking Event sub-status message",
            "example": "Departure Scan"
          },
          "location": {
            "type": "string",
            "description": "Tracking Event location",
            "example": "SAN FRANCISCO CA DISTRIBUTION CENTER"
          },
          "city": {
            "type": "string",
            "description": "Tracking Event city",
            "example": "SAN FRANCISCO"
          },
          "state": {
            "type": "string",
            "description": "Tracking Event state",
            "example": "CA"
          },
          "zip": {
            "type": "string",
            "description": "Tracking Event zip",
            "example": "94134"
          },
          "code": {
            "type": "string",
            "description": "Tracking Event status code",
            "example": "T1"
          }
        }
      },
      "RmaBasic": {
        "required": [
          "created_at",
          "number",
          "order",
          "resolution_trigger",
          "shipping_provider",
          "shipping_required",
          "status"
        ],
        "type": "object",
        "properties": {
          "number": {
            "type": "string",
            "description": "The unique identifier for the RMA",
            "example": "RTN6053474610"
          },
          "status": {
            "type": "string",
            "description": "The current status of the RMA",
            "example": "verified",
            "enum": [
              "authorized",
              "shipped",
              "received",
              "verified",
              "expired",
              "canceled",
              "error"
            ]
          },
          "shipping_required": {
            "type": "boolean",
            "description": "Whether the RMA requires the customer to ship the item back"
          },
          "resolution_trigger": {
            "type": "string",
            "description": "When the RMA resolutions are triggered",
            "example": "shipped",
            "enum": [
              "shipped",
              "received",
              "verified"
            ]
          },
          "shipping_provider": {
            "type": "string",
            "description": "The shipping provider for the RMA",
            "example": "fedex"
          },
          "order": {
            "type": "object",
            "description": "The Order the Return is associated with",
            "allOf": [
              {
                "$ref": "#/components/schemas/Order"
              }
            ]
          },
          "created_at": {
            "type": "string",
            "description": "The date and time the RMA was generated. RFC 3339. ",
            "format": "date-time"
          }
        }
      }
    },
    "securitySchemes": {
      "secretKey": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header"
      }
    }
  },
  "x-original-swagger-version": "2.0"
}
```