Get Recommendation

Retrieve detailed recommendation by ID

GET /api/recommendations/:id

Get Recommendation

cURL

curl --request GET \
  --url https://api.example.com/api/recommendations/:id

200

{
  "success": true,
  "data": {
    "recommendation_id": 123,
    "user_id": 123,
    "user_name": "<string>",
    "email": "<string>",
    "terrain_name": "<string>",
    "soil_type": "<string>",
    "slope_percentage": 123,
    "tractor_name": "<string>",
    "tractor_brand": "<string>",
    "tractor_model": "<string>",
    "engine_power_hp": 123,
    "implement_name": "<string>",
    "implement_type": "<string>",
    "power_requirement_hp": 123,
    "compatibility_score": 123,
    "observations": "<string>",
    "work_type": "<string>",
    "recommendation_date": "<string>"
  }
}

Overview

Retrieves complete details of a specific recommendation including user, terrain, tractor, implement data, compatibility score, and detailed observations.

Users can only access their own recommendations.

Authentication

Required: Bearer token in Authorization header

Authorization: Bearer <your_jwt_token>

Path Parameters

id · integer · required

The unique identifier of the recommendation

Response

success · boolean

Indicates if the request was successful

data · object

Complete recommendation details

Show Recommendation properties

recommendation_id · integer

Unique recommendation identifier

user_id · integer

ID of the user who requested the recommendation

user_name · string

Name of the user

email · string

User’s email address

terrain_name · string

Name of the terrain

soil_type · string

Type of soil

slope_percentage · number

Terrain slope percentage

tractor_name · string

Name of the recommended tractor

tractor_brand · string

Brand of the tractor

tractor_model · string

Model of the tractor

engine_power_hp · number

Engine power in horsepower

implement_name · string

Name of the implement

implement_type · string

Type of implement

power_requirement_hp · number

Power requirement in horsepower

compatibility_score · number

Overall compatibility score (0-100)

observations · string

JSON string containing detailed ranking, score breakdown, and explanation

work_type · string

Type of agricultural work

recommendation_date · string

ISO 8601 timestamp of when the recommendation was generated

Examples

cURL

curl -X GET "http://localhost:4000/api/recommendations/15" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json"

Response Example (200 OK)

{
  "success": true,
  "data": {
    "recommendation_id": 15,
    "user_id": 3,
    "user_name": "Juan Pérez",
    "email": "[e-mail]",
    "terrain_name": "Highland Farm North",
    "soil_type": "Clay",
    "slope_percentage": 18.5,
    "tractor_name": "New Holland T6.175",
    "tractor_brand": "New Holland",
    "tractor_model": "T6.175",
    "engine_power_hp": 175,
    "implement_name": "3-body disc plow",
    "implement_type": "plow",
    "power_requirement_hp": 120,
    "compatibility_score": 87.5,
    "observations": "{\"rank\":1,\"scores\":{\"efficiency\":28,\"traction\":25,\"soil\":18,\"economic\":10,\"availability\":10},\"explanation\":\"Optimal match for steep terrain with clay soil. 4x4 traction provides safety. Power utilization at 89.5%\"}",
    "work_type": "tillage",
    "recommendation_date": "2026-03-10T15:30:00.000Z"
  }
}

Error Responses

Status Code	Description
401	Missing or invalid authentication token
404	Recommendation not found or doesn’t belong to user
500	Internal server error

Observations Field

The observations field contains a JSON string with detailed scoring information:

{
  "rank": 1,
  "scores": {
    "efficiency": 28,
    "traction": 25,
    "soil": 18,
    "economic": 10,
    "availability": 10
  },
  "explanation": "Detailed reasoning for the recommendation"
}

Related Endpoints

Generate Recommendation

Generate new tractor recommendations

Recommendation History

View all recommendations

Source Code Reference

• Route: src/routes/recommendation.routes.js:312
• Controller: src/controllers/recommendationController.js:getRecommendationById