{
 "openapi": "3.0.3",
 "info": {
  "title": "Rose API",
  "version": "1.0.0",
  "description": "Read-only access to one Consignor Connect store's items, sales, consignors / vendors and payouts. Needs Rose Enterprise and an API key made in Rose (Settings - ROSE API).",
  "contact": {
   "name": "Consignor Connect",
   "url": "https://consignorconnect.com"
  }
 },
 "servers": [
  {
   "url": "https://app.shr-consignorconnect.com/rose/api/v1"
  }
 ],
 "security": [
  {
   "roseKey": []
  }
 ],
 "tags": [
  {
   "name": "Store"
  },
  {
   "name": "Items"
  },
  {
   "name": "Sales"
  },
  {
   "name": "Consignors"
  },
  {
   "name": "Payouts"
  }
 ],
 "paths": {
  "/store": {
   "get": {
    "operationId": "getStore",
    "tags": [
     "Store"
    ],
    "summary": "Get the store",
    "description": "The store the key belongs to: name, currency, time zone and its locations. Location codes are the location filter of the other endpoints.",
    "parameters": [],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "data": {
           "$ref": "#/components/schemas/Store"
          }
         }
        }
       }
      }
     },
     "401": {
      "description": "No key, a wrong key or a revoked key (unauthorized).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "403": {
      "description": "The store doesn't have Rose Enterprise (no_enterprise) or its account isn't open (store_closed).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "404": {
      "description": "No such item or account (not_found).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "429": {
      "description": "More than 120 requests a minute for this key (rate_limited).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "500": {
      "description": "Something went wrong (server_error) - try again.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    }
   }
  },
  "/items": {
   "get": {
    "operationId": "listItems",
    "tags": [
     "Items"
    ],
    "summary": "List items in stock",
    "description": "Items on the floor, in SKU order. Sold items are under /sales.",
    "parameters": [
     {
      "name": "account",
      "in": "query",
      "required": false,
      "description": "Only this consignor / vendor account.",
      "schema": {
       "type": "string",
       "example": "1042"
      }
     },
     {
      "name": "location",
      "in": "query",
      "required": false,
      "description": "Only this location code.",
      "schema": {
       "type": "string",
       "example": "1"
      }
     },
     {
      "name": "category",
      "in": "query",
      "required": false,
      "description": "Only this category name.",
      "schema": {
       "type": "string",
       "example": "Outerwear"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Rows per page, 1-500.",
      "schema": {
       "type": "integer",
       "default": 100,
       "minimum": 1,
       "maximum": 500
      }
     },
     {
      "name": "offset",
      "in": "query",
      "required": false,
      "description": "Rows to skip: use next_offset from the previous page.",
      "schema": {
       "type": "integer",
       "default": 0,
       "minimum": 0,
       "maximum": 200000
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "data": {
           "type": "array",
           "items": {
            "$ref": "#/components/schemas/Item"
           }
          },
          "limit": {
           "type": "integer"
          },
          "offset": {
           "type": "integer"
          },
          "next_offset": {
           "type": "integer",
           "nullable": true
          }
         }
        }
       }
      }
     },
     "400": {
      "description": "A parameter is missing or out of range (bad_dates, bad_limit, bad_offset).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "401": {
      "description": "No key, a wrong key or a revoked key (unauthorized).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "403": {
      "description": "The store doesn't have Rose Enterprise (no_enterprise) or its account isn't open (store_closed).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "429": {
      "description": "More than 120 requests a minute for this key (rate_limited).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "500": {
      "description": "Something went wrong (server_error) - try again.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    }
   }
  },
  "/items/{sku}": {
   "get": {
    "operationId": "getItem",
    "tags": [
     "Items"
    ],
    "summary": "Get one item",
    "description": "One item in stock by SKU. 404 when it is not in stock (a sold item: /sales?sku=).",
    "parameters": [
     {
      "name": "sku",
      "in": "path",
      "required": true,
      "description": "The item's SKU.",
      "schema": {
       "type": "string",
       "example": "100245"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "data": {
           "$ref": "#/components/schemas/Item"
          }
         }
        }
       }
      }
     },
     "400": {
      "description": "A parameter is missing or out of range (bad_dates, bad_limit, bad_offset).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "401": {
      "description": "No key, a wrong key or a revoked key (unauthorized).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "403": {
      "description": "The store doesn't have Rose Enterprise (no_enterprise) or its account isn't open (store_closed).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "404": {
      "description": "No such item or account (not_found).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "429": {
      "description": "More than 120 requests a minute for this key (rate_limited).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "500": {
      "description": "Something went wrong (server_error) - try again.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    }
   }
  },
  "/sales": {
   "get": {
    "operationId": "listSales",
    "tags": [
     "Sales"
    ],
    "summary": "List sales",
    "description": "Sold item lines (sales and returns) by date sold. Fees, charges, credits and payouts are not sales and are left out.",
    "parameters": [
     {
      "name": "from",
      "in": "query",
      "required": true,
      "description": "First day, yyyy-MM-dd (included).",
      "schema": {
       "type": "string",
       "example": "2026-10-01"
      }
     },
     {
      "name": "to",
      "in": "query",
      "required": true,
      "description": "Last day, yyyy-MM-dd (included). At most 366 days after from.",
      "schema": {
       "type": "string",
       "example": "2026-10-31"
      }
     },
     {
      "name": "account",
      "in": "query",
      "required": false,
      "description": "Only this account.",
      "schema": {
       "type": "string",
       "example": "1042"
      }
     },
     {
      "name": "location",
      "in": "query",
      "required": false,
      "description": "Only this location code.",
      "schema": {
       "type": "string",
       "example": "1"
      }
     },
     {
      "name": "sku",
      "in": "query",
      "required": false,
      "description": "Only this SKU.",
      "schema": {
       "type": "string",
       "example": "100245"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Rows per page, 1-500.",
      "schema": {
       "type": "integer",
       "default": 100,
       "minimum": 1,
       "maximum": 500
      }
     },
     {
      "name": "offset",
      "in": "query",
      "required": false,
      "description": "Rows to skip: use next_offset from the previous page.",
      "schema": {
       "type": "integer",
       "default": 0,
       "minimum": 0,
       "maximum": 200000
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "data": {
           "type": "array",
           "items": {
            "$ref": "#/components/schemas/Sale"
           }
          },
          "limit": {
           "type": "integer"
          },
          "offset": {
           "type": "integer"
          },
          "next_offset": {
           "type": "integer",
           "nullable": true
          }
         }
        }
       }
      }
     },
     "400": {
      "description": "A parameter is missing or out of range (bad_dates, bad_limit, bad_offset).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "401": {
      "description": "No key, a wrong key or a revoked key (unauthorized).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "403": {
      "description": "The store doesn't have Rose Enterprise (no_enterprise) or its account isn't open (store_closed).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "429": {
      "description": "More than 120 requests a minute for this key (rate_limited).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "500": {
      "description": "Something went wrong (server_error) - try again.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    }
   }
  },
  "/consignors": {
   "get": {
    "operationId": "listConsignors",
    "tags": [
     "Consignors"
    ],
    "summary": "List consignors and vendors",
    "description": "Accounts in account-number order, with their balance due. Contact details only for keys allowed to read them.",
    "parameters": [
     {
      "name": "vendor",
      "in": "query",
      "required": false,
      "description": "true = vendors only, false = consignors only.",
      "schema": {
       "type": "boolean"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Rows per page, 1-500.",
      "schema": {
       "type": "integer",
       "default": 100,
       "minimum": 1,
       "maximum": 500
      }
     },
     {
      "name": "offset",
      "in": "query",
      "required": false,
      "description": "Rows to skip: use next_offset from the previous page.",
      "schema": {
       "type": "integer",
       "default": 0,
       "minimum": 0,
       "maximum": 200000
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "data": {
           "type": "array",
           "items": {
            "$ref": "#/components/schemas/Consignor"
           }
          },
          "limit": {
           "type": "integer"
          },
          "offset": {
           "type": "integer"
          },
          "next_offset": {
           "type": "integer",
           "nullable": true
          }
         }
        }
       }
      }
     },
     "400": {
      "description": "A parameter is missing or out of range (bad_dates, bad_limit, bad_offset).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "401": {
      "description": "No key, a wrong key or a revoked key (unauthorized).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "403": {
      "description": "The store doesn't have Rose Enterprise (no_enterprise) or its account isn't open (store_closed).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "429": {
      "description": "More than 120 requests a minute for this key (rate_limited).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "500": {
      "description": "Something went wrong (server_error) - try again.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    }
   }
  },
  "/consignors/{account}": {
   "get": {
    "operationId": "getConsignor",
    "tags": [
     "Consignors"
    ],
    "summary": "Get one consignor or vendor",
    "description": "One account by its number.",
    "parameters": [
     {
      "name": "account",
      "in": "path",
      "required": true,
      "description": "The account number.",
      "schema": {
       "type": "string",
       "example": "1042"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "data": {
           "$ref": "#/components/schemas/Consignor"
          }
         }
        }
       }
      }
     },
     "400": {
      "description": "A parameter is missing or out of range (bad_dates, bad_limit, bad_offset).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "401": {
      "description": "No key, a wrong key or a revoked key (unauthorized).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "403": {
      "description": "The store doesn't have Rose Enterprise (no_enterprise) or its account isn't open (store_closed).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "404": {
      "description": "No such item or account (not_found).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "429": {
      "description": "More than 120 requests a minute for this key (rate_limited).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "500": {
      "description": "Something went wrong (server_error) - try again.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    }
   }
  },
  "/payouts": {
   "get": {
    "operationId": "listPayouts",
    "tags": [
     "Payouts"
    ],
    "summary": "List payouts",
    "description": "Payouts made to consignors and vendors, by date.",
    "parameters": [
     {
      "name": "from",
      "in": "query",
      "required": true,
      "description": "First day, yyyy-MM-dd (included).",
      "schema": {
       "type": "string",
       "example": "2026-10-01"
      }
     },
     {
      "name": "to",
      "in": "query",
      "required": true,
      "description": "Last day, yyyy-MM-dd (included). At most 366 days after from.",
      "schema": {
       "type": "string",
       "example": "2026-10-31"
      }
     },
     {
      "name": "account",
      "in": "query",
      "required": false,
      "description": "Only this account.",
      "schema": {
       "type": "string",
       "example": "1042"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Rows per page, 1-500.",
      "schema": {
       "type": "integer",
       "default": 100,
       "minimum": 1,
       "maximum": 500
      }
     },
     {
      "name": "offset",
      "in": "query",
      "required": false,
      "description": "Rows to skip: use next_offset from the previous page.",
      "schema": {
       "type": "integer",
       "default": 0,
       "minimum": 0,
       "maximum": 200000
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "data": {
           "type": "array",
           "items": {
            "$ref": "#/components/schemas/Payout"
           }
          },
          "limit": {
           "type": "integer"
          },
          "offset": {
           "type": "integer"
          },
          "next_offset": {
           "type": "integer",
           "nullable": true
          }
         }
        }
       }
      }
     },
     "400": {
      "description": "A parameter is missing or out of range (bad_dates, bad_limit, bad_offset).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "401": {
      "description": "No key, a wrong key or a revoked key (unauthorized).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "403": {
      "description": "The store doesn't have Rose Enterprise (no_enterprise) or its account isn't open (store_closed).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "429": {
      "description": "More than 120 requests a minute for this key (rate_limited).",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     },
     "500": {
      "description": "Something went wrong (server_error) - try again.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Error"
        }
       }
      }
     }
    }
   }
  }
 },
 "components": {
  "securitySchemes": {
   "roseKey": {
    "type": "http",
    "scheme": "bearer",
    "description": "Authorization: Bearer rose_<id>_<secret>"
   }
  },
  "schemas": {
   "Location": {
    "type": "object",
    "properties": {
     "code": {
      "type": "string",
      "example": "1"
     },
     "name": {
      "type": "string",
      "example": "Main Street"
     }
    }
   },
   "Store": {
    "type": "object",
    "properties": {
     "store": {
      "type": "string",
      "example": "MyStore",
      "description": "The store's account name in Consignor Connect."
     },
     "name": {
      "type": "string",
      "example": "My Store",
      "description": "The store's full name."
     },
     "preview": {
      "type": "boolean",
      "example": false,
      "description": "true while the store is trying the new Rose (a copy of its data)."
     },
     "currency_symbol": {
      "type": "string",
      "example": "$"
     },
     "timezone": {
      "type": "string",
      "example": "America/New_York"
     },
     "locations": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/Location"
      }
     }
    }
   },
   "Item": {
    "type": "object",
    "properties": {
     "sku": {
      "type": "string",
      "example": "100245"
     },
     "account": {
      "type": "string",
      "example": "1042",
      "description": "The consignor / vendor account the item belongs to."
     },
     "description": {
      "type": "string",
      "example": "Blue denim jacket"
     },
     "brand": {
      "type": "string",
      "example": "Levi's"
     },
     "category": {
      "type": "string",
      "example": "Outerwear"
     },
     "size": {
      "type": "string",
      "example": "M"
     },
     "color": {
      "type": "string",
      "example": "Blue"
     },
     "quantity": {
      "type": "number",
      "example": 1
     },
     "price": {
      "type": "number",
      "example": 38.0,
      "description": "Selling price."
     },
     "cost": {
      "type": "number",
      "example": 0
     },
     "consignor_split_percent": {
      "type": "number",
      "example": 50,
      "description": "The consignor's share of the sale, in %."
     },
     "shelf_date": {
      "type": "string",
      "example": "2026-10-02",
      "description": "yyyy-MM-dd",
      "nullable": true
     },
     "expires": {
      "type": "string",
      "example": "2026-12-31",
      "description": "yyyy-MM-dd",
      "nullable": true
     },
     "never_expires": {
      "type": "boolean",
      "example": false
     },
     "no_discounts": {
      "type": "boolean",
      "example": false,
      "description": "true = the item is never discounted."
     },
     "location": {
      "$ref": "#/components/schemas/Location"
     },
     "status": {
      "type": "string",
      "example": ""
     }
    }
   },
   "Sale": {
    "type": "object",
    "properties": {
     "sku": {
      "type": "string",
      "example": "100245"
     },
     "account": {
      "type": "string",
      "example": "1042"
     },
     "description": {
      "type": "string",
      "example": "Blue denim jacket"
     },
     "brand": {
      "type": "string",
      "example": "Levi's"
     },
     "category": {
      "type": "string",
      "example": "Outerwear"
     },
     "size": {
      "type": "string",
      "example": "M"
     },
     "quantity": {
      "type": "number",
      "example": 1,
      "description": "Negative for a return."
     },
     "sold_price": {
      "type": "number",
      "example": 38.0
     },
     "consignor_share": {
      "type": "number",
      "example": 19.0,
      "description": "What the consignor / vendor gets for this line."
     },
     "fee": {
      "type": "number",
      "example": 0
     },
     "card_fee": {
      "type": "number",
      "example": 1.1
     },
     "discount": {
      "type": "number",
      "example": 0
     },
     "tax": {
      "type": "number",
      "example": 2.66
     },
     "date_sold": {
      "type": "string",
      "example": "2026-11-03",
      "description": "yyyy-MM-dd"
     },
     "paid_to_consignor": {
      "type": "boolean",
      "example": false,
      "description": "Whether the consignor's share has been paid out yet."
     },
     "date_paid": {
      "type": "string",
      "description": "yyyy-MM-dd",
      "nullable": true
     },
     "location": {
      "$ref": "#/components/schemas/Location"
     }
    }
   },
   "Address": {
    "type": "object",
    "properties": {
     "line1": {
      "type": "string",
      "example": "1 Main St"
     },
     "line2": {
      "type": "string",
      "example": ""
     },
     "city": {
      "type": "string",
      "example": "Springfield"
     },
     "state": {
      "type": "string",
      "example": "IL"
     },
     "zip": {
      "type": "string",
      "example": "62701"
     }
    }
   },
   "Consignor": {
    "type": "object",
    "properties": {
     "account": {
      "type": "string",
      "example": "1042"
     },
     "name": {
      "type": "string",
      "example": "Jane Smith"
     },
     "business": {
      "type": "string",
      "example": ""
     },
     "vendor": {
      "type": "boolean",
      "example": false,
      "description": "true = a vendor (booth renter, maker) rather than a consignor."
     },
     "store_account": {
      "type": "boolean",
      "example": false,
      "description": "The store's own house account."
     },
     "split_percent": {
      "type": "number",
      "example": 50
     },
     "balance_due": {
      "type": "number",
      "example": 57.25,
      "description": "What the store owes this account now."
     },
     "paid_ytd": {
      "type": "number",
      "example": 412.0
     },
     "last_paid": {
      "type": "string",
      "example": "2026-10-15",
      "description": "yyyy-MM-dd",
      "nullable": true
     },
     "created": {
      "type": "string",
      "example": "2025-03-08",
      "description": "yyyy-MM-dd",
      "nullable": true
     },
     "status": {
      "type": "string",
      "example": ""
     },
     "email": {
      "type": "string",
      "example": "jane@example.com",
      "description": "Only for keys allowed to read contact details."
     },
     "phone_cell": {
      "type": "string",
      "example": "555-0100",
      "description": "Contact-details keys only."
     },
     "phone_home": {
      "type": "string",
      "example": "",
      "description": "Contact-details keys only."
     },
     "phone_business": {
      "type": "string",
      "example": "",
      "description": "Contact-details keys only."
     },
     "address": {
      "allOf": [
       {
        "$ref": "#/components/schemas/Address"
       }
      ],
      "description": "Contact-details keys only."
     }
    }
   },
   "Payout": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "example": "6f1c2a\u2026",
      "description": "Links the payout's receipt."
     },
     "account": {
      "type": "string",
      "example": "1042"
     },
     "type": {
      "type": "string",
      "enum": [
       "PAYOUT",
       "PARTIAL PAYOUT"
      ],
      "example": "PAYOUT"
     },
     "amount": {
      "type": "number",
      "example": 412.0,
      "description": "A negative PARTIAL PAYOUT reverses one."
     },
     "date": {
      "type": "string",
      "example": "2026-10-15",
      "description": "yyyy-MM-dd"
     },
     "method": {
      "type": "string",
      "example": "CHECK",
      "description": "How it was paid, as typed in Rose."
     },
     "reference": {
      "type": "string",
      "example": "10233",
      "description": "Check or transfer number."
     },
     "location": {
      "$ref": "#/components/schemas/Location"
     }
    }
   },
   "Error": {
    "type": "object",
    "properties": {
     "error": {
      "type": "object",
      "properties": {
       "code": {
        "type": "string",
        "example": "unauthorized"
       },
       "message": {
        "type": "string",
        "example": "Send a Rose API key: Authorization: Bearer rose_..."
       }
      }
     }
    }
   }
  }
 }
}