---
agentTools:
  projectIndex: https://quiver.readme.io/llms.txt
---

# Get one recommendation and its proposed line items.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Fulfilment",
    "description": "...",
    "version": "1.0"
  },
  "tags": [
    {
      "name": "InventoryRecommendationService"
    }
  ],
  "paths": {
    "/inventory-recommendations/{inventoryRecommendationId}": {
      "get": {
        "summary": "Get one recommendation and its proposed line items.",
        "operationId": "InventoryRecommendationService_GetInventoryRecommendation",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/fulfilmentInventoryRecommendation"
                }
              }
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/rpcStatus"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "inventoryRecommendationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "InventoryRecommendationService"
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://api.quiver.london/fulfilment"
    }
  ],
  "components": {
    "schemas": {
      "fulfilmentInventoryMovementType": {
        "type": "string",
        "enum": [
          "INVENTORY_MOVEMENT_TYPE_MERCHANT_TO_QUIVER",
          "INVENTORY_MOVEMENT_TYPE_QUIVER_TO_MERCHANT",
          "INVENTORY_MOVEMENT_TYPE_WAREHOUSE_TO_STORE",
          "INVENTORY_MOVEMENT_TYPE_STORE_TO_STORE",
          "INVENTORY_MOVEMENT_TYPE_QUIVER_TO_STORE"
        ]
      },
      "fulfilmentInventoryRecommendation": {
        "type": "object",
        "properties": {
          "inventoryRecommendationId": {
            "type": "integer",
            "format": "int32"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "inventoryRunId": {
            "type": "integer",
            "format": "int32"
          },
          "status": {
            "$ref": "#/components/schemas/fulfilmentInventoryRecommendationStatus"
          },
          "movementType": {
            "$ref": "#/components/schemas/fulfilmentInventoryMovementType"
          },
          "lineItems": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/fulfilmentInventoryRecommendationLineItem"
            }
          },
          "decisionDueAt": {
            "type": "string",
            "format": "date-time"
          },
          "version": {
            "type": "integer",
            "format": "int32"
          },
          "sourceLocationId": {
            "type": "string"
          },
          "sourceLocationName": {
            "type": "string"
          },
          "destinationLocationId": {
            "type": "string"
          },
          "destinationLocationName": {
            "type": "string"
          },
          "destinationAddress": {
            "type": "string"
          },
          "recipientName": {
            "type": "string"
          },
          "recipientEmail": {
            "type": "string"
          },
          "recipientPhone": {
            "type": "string"
          },
          "coverageBefore": {
            "type": "number",
            "format": "double"
          },
          "expectedCoverageAfter": {
            "type": "number",
            "format": "double"
          },
          "decisionBy": {
            "type": "string"
          },
          "decidedAt": {
            "type": "string",
            "format": "date-time"
          },
          "declineReason": {
            "$ref": "#/components/schemas/fulfilmentInventoryRecommendationDeclineReason"
          },
          "decisionNote": {
            "type": "string"
          },
          "inventoryTransferId": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "fulfilmentInventoryRecommendationDeclineReason": {
        "type": "string",
        "enum": [
          "INVENTORY_RECOMMENDATION_DECLINE_REASON_STOCK_UNAVAILABLE",
          "INVENTORY_RECOMMENDATION_DECLINE_REASON_PACK_SIZE_INCORRECT",
          "INVENTORY_RECOMMENDATION_DECLINE_REASON_PROMOTION_OR_LAUNCH",
          "INVENTORY_RECOMMENDATION_DECLINE_REASON_LOCATION_CONSTRAINT",
          "INVENTORY_RECOMMENDATION_DECLINE_REASON_RECOMMENDATION_INACCURATE",
          "INVENTORY_RECOMMENDATION_DECLINE_REASON_REPLENISHING_SEPARATELY",
          "INVENTORY_RECOMMENDATION_DECLINE_REASON_OTHER"
        ]
      },
      "fulfilmentInventoryRecommendationLineItem": {
        "type": "object",
        "properties": {
          "sku": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "proposedQuantity": {
            "type": "integer",
            "format": "int32"
          },
          "selectedQuantity": {
            "type": "integer",
            "format": "int32"
          },
          "rawQuantity": {
            "type": "integer",
            "format": "int32"
          },
          "packSize": {
            "type": "integer",
            "format": "int32"
          },
          "proposedPacks": {
            "type": "integer",
            "format": "int32"
          },
          "targetStock": {
            "type": "integer",
            "format": "int32"
          },
          "heldStock": {
            "type": "integer",
            "format": "int32"
          },
          "confirmedInbound": {
            "type": "integer",
            "format": "int32"
          },
          "minimumRetainedStock": {
            "type": "integer",
            "format": "int32"
          },
          "explanation": {
            "type": "string"
          }
        }
      },
      "fulfilmentInventoryRecommendationStatus": {
        "type": "string",
        "enum": [
          "INVENTORY_RECOMMENDATION_STATUS_DRAFT",
          "INVENTORY_RECOMMENDATION_STATUS_AWAITING_DECISION",
          "INVENTORY_RECOMMENDATION_STATUS_ACCEPTED",
          "INVENTORY_RECOMMENDATION_STATUS_EDITED_AND_ACCEPTED",
          "INVENTORY_RECOMMENDATION_STATUS_DECLINED",
          "INVENTORY_RECOMMENDATION_STATUS_OVERDUE",
          "INVENTORY_RECOMMENDATION_STATUS_IN_EXECUTION",
          "INVENTORY_RECOMMENDATION_STATUS_COMPLETED",
          "INVENTORY_RECOMMENDATION_STATUS_FAILED"
        ]
      },
      "protobufAny": {
        "type": "object",
        "properties": {
          "@type": {
            "type": "string"
          }
        },
        "additionalProperties": {}
      },
      "rpcStatus": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32"
          },
          "message": {
            "type": "string"
          },
          "details": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/protobufAny"
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "_id": {
    "buffer": {
      "0": 100,
      "1": 231,
      "2": 26,
      "3": 254,
      "4": 74,
      "5": 54,
      "6": 78,
      "7": 0,
      "8": 13,
      "9": 225,
      "10": 4,
      "11": 102
    }
  }
}
```