Get a journey run

GET

projects

{projectId}

journey-runs

{runId}

Get a journey run

curl --request GET \
  --url https://app.mcpjam.com/api/v1/projects/{projectId}/journey-runs/{runId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.mcpjam.com/api/v1/projects/{projectId}/journey-runs/{runId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.mcpjam.com/api/v1/projects/{projectId}/journey-runs/{runId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.mcpjam.com/api/v1/projects/{projectId}/journey-runs/{runId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.mcpjam.com/api/v1/projects/{projectId}/journey-runs/{runId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.mcpjam.com/api/v1/projects/{projectId}/journey-runs/{runId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "projectId": "<string>",
  "journeyId": "<string>",
  "canceled": true,
  "stale": true,
  "summary": {
    "total": 123,
    "succeeded": 123,
    "failed": 123,
    "rateLimited": 123
  },
  "targets": [
    {
      "hostId": "<string>",
      "hostName": "<string>",
      "targetId": "<string>",
      "modelId": "<string>"
    }
  ],
  "createdAt": 123,
  "waveId": "<string>",
  "error": "<string>",
  "persona": {
    "personaId": "<string>",
    "name": "<string>",
    "role": "<string>"
  },
  "attempts": [
    {
      "chatSessionId": "<string>",
      "hostId": "<string>",
      "targetId": "<string>",
      "sessionIndex": 123,
      "errorCode": "<string>",
      "errorMessage": "<string>"
    }
  ],
  "targetSummaries": [
    {
      "hostId": "<string>",
      "total": 123,
      "succeeded": 123,
      "failed": 123,
      "rateLimited": 123,
      "targetId": "<string>"
    }
  ],
  "lastHeartbeatAt": 123,
  "insights": {
    "schemaVersion": 1,
    "scope": {
      "id": "<string>",
      "runId": "<string>",
      "scenarioId": "<string>",
      "windowStartAt": 123,
      "windowEndAt": 123
    },
    "reasonCode": "<string>",
    "retryable": true,
    "error": {
      "code": "<string>",
      "message": "<string>"
    },
    "generatedAt": 123,
    "updatedAt": 123,
    "summary": "<string>",
    "coverage": {
      "analyzed": 123,
      "total": 123,
      "truncated": true,
      "lowConfidence": true,
      "gradedCount": 123,
      "feedbackCount": 123
    },
    "findings": [
      {
        "id": "<string>",
        "signalFingerprint": "<string>",
        "title": "<string>",
        "observed": "<string>",
        "recommendation": "<string>",
        "acceptanceCriteria": [
          "<string>"
        ],
        "affected": {
          "count": 123,
          "total": 123
        },
        "evidence": [
          {
            "excerpt": "<string>",
            "sessionId": "<string>",
            "iterationId": "<string>",
            "toolName": "<string>",
            "errorCode": "<string>"
          }
        ],
        "rootCause": "<string>",
        "patternSlug": "<string>",
        "target": {
          "serverId": "<string>",
          "snapshotHash": "<string>",
          "toolName": "<string>",
          "fieldPath": "<string>",
          "currentDefinition": {
            "truncated": true,
            "description": "<string>",
            "inputSchemaJson": "<string>",
            "outputSchemaJson": "<string>"
          }
        }
      }
    ],
    "truncation": {
      "truncated": true,
      "omittedFindings": 123,
      "omittedEvidence": 123,
      "contractTruncated": true
    },
    "runHealth": {
      "targets": [
        {
          "subjectId": "<string>",
          "subjectLabel": "<string>",
          "attempted": 123,
          "succeeded": 123,
          "failed": 123,
          "rateLimited": 123
        }
      ]
    }
  }
}

Authorizations

Authorization

string

header

required

MCPJam API key (sk_…). Create one at Settings → API keys. Guest sessions cannot use the API, and API keys cannot manage other API keys.

Path Parameters

projectId

string

required

ID of the hosted project that contains the server.

runId

string

required

Eval run ID, as returned by POST /eval-runs.

Response

The run.

string

required

projectId

string

required

journeyId

string

required

status

enum<string>

required

Poll until it leaves running.

Available options:

running,

completed,

partial,

failed,

rate_limited

canceled

boolean

required

True when somebody STOPPED this run. Check this before showing a run as a failure: a cancelled run reports status: "failed", because cancellation is recorded as a marker rather than a status of its own.

stale

boolean

required

True when the runner went silent and the watchdog settled the run. Distinct from a run that failed while still reporting.

summary

object

required

Show child attributes

targets

object[]

required

Show child attributes

createdAt

number

required

Epoch milliseconds.

waveId

string

The batch this run was launched with. Sibling runs of one co-launched wave share it; a solo relaunch is a wave of one. Absent on a run launched without one.

error

string

Raw marker behind canceled / stale.

persona

object

The persona AS PINNED AT LAUNCH, from the run's immutable snapshot — not the persona's current values, which may have been edited since.

Show child attributes

attempts

object[]

Per-session execution records. Present on the single-run read only — lists stay compact.

Show child attributes

targetSummaries

object[]

The same counts as summary, broken down per target.

Show child attributes

lastHeartbeatAt

number

Epoch milliseconds of the runner's last check-in. A long-stale heartbeat on a running run is what the watchdog acts on.

insights

object

The common actionable-insights envelope. Present on the DETAIL response only — lists stay compact — and absent when the caller may not have it or the deployment cannot produce one. Treat absence exactly like status: "not_available".

Show child attributes

⌘I

Get a journey run

curl --request GET \
  --url https://app.mcpjam.com/api/v1/projects/{projectId}/journey-runs/{runId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.mcpjam.com/api/v1/projects/{projectId}/journey-runs/{runId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.mcpjam.com/api/v1/projects/{projectId}/journey-runs/{runId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.mcpjam.com/api/v1/projects/{projectId}/journey-runs/{runId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.mcpjam.com/api/v1/projects/{projectId}/journey-runs/{runId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.mcpjam.com/api/v1/projects/{projectId}/journey-runs/{runId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "projectId": "<string>",
  "journeyId": "<string>",
  "canceled": true,
  "stale": true,
  "summary": {
    "total": 123,
    "succeeded": 123,
    "failed": 123,
    "rateLimited": 123
  },
  "targets": [
    {
      "hostId": "<string>",
      "hostName": "<string>",
      "targetId": "<string>",
      "modelId": "<string>"
    }
  ],
  "createdAt": 123,
  "waveId": "<string>",
  "error": "<string>",
  "persona": {
    "personaId": "<string>",
    "name": "<string>",
    "role": "<string>"
  },
  "attempts": [
    {
      "chatSessionId": "<string>",
      "hostId": "<string>",
      "targetId": "<string>",
      "sessionIndex": 123,
      "errorCode": "<string>",
      "errorMessage": "<string>"
    }
  ],
  "targetSummaries": [
    {
      "hostId": "<string>",
      "total": 123,
      "succeeded": 123,
      "failed": 123,
      "rateLimited": 123,
      "targetId": "<string>"
    }
  ],
  "lastHeartbeatAt": 123,
  "insights": {
    "schemaVersion": 1,
    "scope": {
      "id": "<string>",
      "runId": "<string>",
      "scenarioId": "<string>",
      "windowStartAt": 123,
      "windowEndAt": 123
    },
    "reasonCode": "<string>",
    "retryable": true,
    "error": {
      "code": "<string>",
      "message": "<string>"
    },
    "generatedAt": 123,
    "updatedAt": 123,
    "summary": "<string>",
    "coverage": {
      "analyzed": 123,
      "total": 123,
      "truncated": true,
      "lowConfidence": true,
      "gradedCount": 123,
      "feedbackCount": 123
    },
    "findings": [
      {
        "id": "<string>",
        "signalFingerprint": "<string>",
        "title": "<string>",
        "observed": "<string>",
        "recommendation": "<string>",
        "acceptanceCriteria": [
          "<string>"
        ],
        "affected": {
          "count": 123,
          "total": 123
        },
        "evidence": [
          {
            "excerpt": "<string>",
            "sessionId": "<string>",
            "iterationId": "<string>",
            "toolName": "<string>",
            "errorCode": "<string>"
          }
        ],
        "rootCause": "<string>",
        "patternSlug": "<string>",
        "target": {
          "serverId": "<string>",
          "snapshotHash": "<string>",
          "toolName": "<string>",
          "fieldPath": "<string>",
          "currentDefinition": {
            "truncated": true,
            "description": "<string>",
            "inputSchemaJson": "<string>",
            "outputSchemaJson": "<string>"
          }
        }
      }
    ],
    "truncation": {
      "truncated": true,
      "omittedFindings": 123,
      "omittedEvidence": 123,
      "contractTruncated": true
    },
    "runHealth": {
      "targets": [
        {
          "subjectId": "<string>",
          "subjectLabel": "<string>",
          "attempted": 123,
          "succeeded": 123,
          "failed": 123,
          "rateLimited": 123
        }
      ]
    }
  }
}

API Guides

Endpoints

Authorizations

Path Parameters

Response