GET /v1/dfm-runs/{dfm_run_id}

Summary

Retrieve a stored DFM analysis run

Description

Retrieves a previously created DFM run by its dfm_run_id. Useful for audit trails and referencing specific analysis results.

Request Example

curl -X GET "http://127.0.0.1:8000/api/v1/dfm-runs/dfm_1234567890abcdef" \
  -H "Authorization: Bearer $ASAP_API_KEY"

Response Example

{
  "dfm_run_id": "dfm_1234567890abcdef",
  "board_id": "brd_1234567890abcdef",
  "check_ids": null,
  "created_at": "2026-01-23T13:30:00Z",
  "result": {
    "summary": {
      "overall_score": 0.85,
      "issues_count": 2,
      "checks_run": 5,
      "area_sqin": 1.23,
      "confidence": 0.9
    },
    "issues": [
      {
        "code": "min_trace_width",
        "severity": "warning",
        "message": "Trace width below minimum requirement",
        "location": "Layer: F.Cu, X:1.23,Y:4.56",
        "check_id": "min_trace_width"
      }
    ],
    "area_sqin": 1.23
  }
}

Error Codes

This endpoint may return the following error codes:

Code	Status	Meaning
`missing_auth`	401	No Authorization header provided
`invalid_api_key`	403	API key is invalid or missing
`dfm_run_not_found`	404	DFM run not found

Authentication

This endpoint requires Bearer token authentication: