Documentation / Endpoints / GET /api/repairs

GET /api/repairs

Paid

Retrieve repair intelligence including repairability scores, common repairs, part costs, and technical requirements. Backed by iFixit data where available.

Authentication

Requires Paid tier or higher.

Query Parameters

Either device_id or variant_id is required.

ParameterTypeRequiredDescription
device_idstring*Device identifier (required if variant_id not provided)
variant_idstring*Variant identifier (required if device_id not provided)

Example Request

curl "https://api.souratlas.io/api/repairs?device_id=apple-iphone-14-pro" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": {
    "device_id": "apple-iphone-14-pro",
    "device_name": "Apple iPhone 14 Pro",
    "variant_id": null,
    "ifixit_score": 6,
    "repairability_rating": "Good",
    "common_repairs": [
      {
        "name": "Battery Replacement",
        "difficulty": "Moderate",
        "estimated_time_minutes": 45,
        "parts": [
          {
            "name": "Battery",
            "cost_min": 2500,
            "cost_max": 5000,
            "currency": "USD",
            "availability": "available"
          }
        ],
        "ifixit_guide_url": "https://www.ifixit.com/Guide/iPhone+14+Pro+Battery+Replacement/..."
      },
      {
        "name": "Screen Replacement",
        "difficulty": "Difficult",
        "estimated_time_minutes": 90,
        "parts": [
          {
            "name": "Display Assembly",
            "cost_min": 15000,
            "cost_max": 35000,
            "currency": "USD",
            "availability": "available"
          }
        ],
        "ifixit_guide_url": "https://www.ifixit.com/Guide/iPhone+14+Pro+Screen+Replacement/..."
      }
    ],
    "common_failure_points": [
      "Battery degradation after 2-3 years",
      "Screen cracks from drops",
      "Camera lens scratches"
    ],
    "average_repair_cost": {
      "min": 5000,
      "max": 35000,
      "currency": "USD"
    },
    "repair_roi_indicator": "High",
    "technical_notes": [
      "Requires heat gun for adhesive removal",
      "Display replacement requires Face ID recalibration",
      "Water resistance may be compromised after repair"
    ],
    "proprietary_parts": [
      "Pentalobe screws",
      "Tri-point screws",
      "Proprietary display connector"
    ],
    "special_tools_required": [
      "Pentalobe P2 screwdriver",
      "Tri-point Y000 screwdriver",
      "Suction cup",
      "Spudger",
      "Heat gun or iOpener"
    ],
    "last_updated": "2024-01-15T10:30:00Z",
    "source": "ifixit",
    "data_completeness": 85
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

Response follows the DeviceRepairIntelligence schema. All costs in cents (USD). Fields may be null if data is unavailable.

Data Availability

Repair intelligence is sourced from iFixit where available. The data_completeness field indicates the percentage of available data. Fields like ifixit_score, average_repair_cost, and ifixit_guide_url may be null if data is not available for the device.

Error Responses

StatusError CodeDescription
400VALIDATION_ERRORMissing both device_id and variant_id
401UNAUTHORIZEDMissing or invalid API key
403FORBIDDENRequires paid tier access
404NOT_FOUNDDevice or variant not found
429RATE_LIMIT_EXCEEDEDRate limit exceeded
500INTERNAL_ERRORInternal server error