API Documentation — myQA.team

IFS Analyzer

GET/api/v1/ifs-analyzer/jobs/:jobId

Status and results of an IFS Analyzer batch.

Authentication

Any valid key scoped to the organization that created the job. See Authentication.

Code examples

1curl https://api.myqateam.com/api/v1/ifs-analyzer/jobs/<job-id> \
2  -H "Authorization: Bearer myqa_..."

Response — processing

json

1{
2  "success": true,
3  "data": {
4    "job_id": "94c52cc5-…",
5    "status": "processing",
6    "total": 2,
7    "completed": 1,
8    "failed": 0,
9    "created_at": "2026-10-01T12:00:00Z",
10    "completed_at": null,
11    "processing_time_ms": null,
12    "error": null,
13    "results": [
14      {
15        "index": 0,
16        "status": "completed",
17        "analysis_id": "6f0c…",
18        "reference": "NC-2026-0042",
19        "requirement": { "number": "4.12.1", "text": "…", "is_ko": true },
20        "grade": "Majeur",
21        "reasoning": "…",
22        "critic": { "verdict": "…" },
23        "…": "same fields as the POST /analyze response"
24      }
25    ]
26  }
27}

results holds the observations finished so far, in submission order (index is the position in items). A completed result has every field of the POST /analyze response.

Response — completed

status becomes completed once every observation has run and at least one succeeded. Observations that failed are listed with an error and can be resubmitted:

json

1{
2  "index": 1,
3  "status": "failed",
4  "analysis_id": "…",
5  "reference": "NC-2026-0043",
6  "requirement": { "number": "2.3.9.1" },
7  "error": { "code": "MODEL_ERROR", "message": "The model answer was cut off. Please retry." }
8}

Response — failed

json

1{
2  "success": true,
3  "data": {
4    "job_id": "94c52cc5-…",
5    "status": "failed",
6    "error": {
7      "code": "INTERRUPTED",
8      "message": "The batch was interrupted before it finished. Resubmit the unfinished observations."
9    },
10    "results": [ /* whatever finished before the interruption */ ]
11  }
12}

PROCESSING_ERROR: every observation failed.
INTERRUPTED: the batch stopped before finishing. Resubmit the observations missing from results.
404 NOT_FOUND: the job does not exist or belongs to another organization.