Read a result

GET

/results/{result_id}

const url = 'https://api.prismlet.com/v1/results/0192f5c1-7c1a-7b3e-9f55-3c1d2e4a5b6c?format=json';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.prismlet.com/v1/results/0192f5c1-7c1a-7b3e-9f55-3c1d2e4a5b6c?format=json' \
  --header 'Authorization: Bearer <token>'

Returns a saved result from this account, whether the API, the app or a file run made it. Nothing is sent to the model.

json applies the prism’s current Lens to the stored answers, so a Lens edit changes what an old result returns. raw returns the stored answers and never changes. A failed result answers 200 too, with status set to failed. Results of an archived prism stay readable.

Authorizations

api_key

Parameters

Path Parameters

result_id

required

string format: uuid

The result’s id.

Example

0192f5c1-7c1a-7b3e-9f55-3c1d2e4a5b6c

Query Parameters

format

string

default: json

Allowed values: json raw csv tsv jsonl

What the response body holds.

json: the result, with answers shaped by the prism’s Lens.
raw: the result, with the stored answers and every probability.
csv, tsv: a header row and one row for the result.
jsonl: one line holding the same row as a JSON object.

Defaults to json, also when sent empty. An unknown value answers 400. Errors are JSON in every format.

Responses

200

The result, whether it succeeded or failed.

Any of:

Result (json)
RawResult (raw)

Result (json)

A result in the default json format. answers is shaped by the prism’s current Lens, so editing the Lens changes what an old result returns.

object

required

The result id. Use it to read or retry the result.

string format: uuid

ref

required

The ref sent with the call, or null.

string | null

prism

required

The prism’s slug.

string

version

required

The prism version that answered.

integer

>= 1

status

required

ok, or failed when the model gave no usable answer.

string

Allowed values: ok failed

error

required

Why the result failed, in words. Null when status is ok.

string | null

took_ms

required

How long the call to the model took, in milliseconds.

integer

created_at

required

When the result was saved, ISO 8601 in UTC.

string format: date-time

answers

required

One entry per column of the prism’s Lens, keyed by column name, in Lens order. Null when the result failed.

object | null

RawResult (raw)

A result in raw format, with the stored answers and every probability. Lens edits never change it.

object

required

The result id. Use it to read or retry the result.

string format: uuid

ref

required

The ref sent with the call, or null.

string | null

prism

required

The prism’s slug.

string

version

required

The prism version that answered.

integer

>= 1

status

required

ok, or failed when the model gave no usable answer.

string

Allowed values: ok failed

error

required

Why the result failed, in words. Null when status is ok.

string | null

took_ms

required

How long the call to the model took, in milliseconds.

integer

created_at

required

When the result was saved, ISO 8601 in UTC.

string format: date-time

answers

required

The stored answer to every question, keyed by question key. Null when the result failed.

object | null

Examples

Answered, format=json

{
  "id": "0192f5c1-7c1a-7b3e-9f55-3c1d2e4a5b6c",
  "ref": "TCK-8812",
  "prism": "support-routing",
  "version": 3,
  "status": "ok",
  "error": null,
  "took_ms": 640,
  "created_at": "2026-09-23T09:14:02.187Z",
  "answers": {
    "team": "billing",
    "team_probability": 0.91,
    "urgent": "yes",
    "tone": "annoyed",
    "tone_average": 2.05
  }
}

Failed, format=json

{
  "id": "0192f5c3-2b4e-7d10-8a61-5e0f9c7d2a13",
  "ref": "TCK-8812",
  "prism": "support-routing",
  "version": 3,
  "status": "failed",
  "error": "The model took too long to answer, so we stopped after 15 seconds.",
  "took_ms": 15012,
  "created_at": "2026-09-23T09:15:40.502Z",
  "answers": null
}

Answered, format=raw

{
  "id": "0192f5c1-7c1a-7b3e-9f55-3c1d2e4a5b6c",
  "ref": "TCK-8812",
  "prism": "support-routing",
  "version": 3,
  "status": "ok",
  "error": null,
  "took_ms": 640,
  "created_at": "2026-09-23T09:14:02.187Z",
  "answers": {
    "team": {
      "type": "choice",
      "value": "billing",
      "probabilities": {
        "billing": 0.91,
        "technical": 0.05,
        "other": 0.03,
        "insufficient_information": 0.01
      },
      "confidence": 0.88
    },
    "urgent": {
      "type": "yes_no",
      "probability": 0.83
    },
    "tone": {
      "type": "scale",
      "level": "annoyed",
      "probabilities": {
        "calm": 0.12,
        "annoyed": 0.71,
        "angry": 0.17
      }
    }
  }
}

Failed, format=raw

{
  "id": "0192f5c3-2b4e-7d10-8a61-5e0f9c7d2a13",
  "ref": "TCK-8812",
  "prism": "support-routing",
  "version": 3,
  "status": "failed",
  "error": "The model took too long to answer, so we stopped after 15 seconds.",
  "took_ms": 15012,
  "created_at": "2026-09-23T09:15:40.502Z",
  "answers": null
}

A header row, then one row. The columns are result_id, ref, version, status, error, created_at, one per field of the latest prism version, then the Lens columns. Cells hold option labels and Yes, No or Unsure. Lines end in CRLF. A cell holding a comma, a quote or a line break is quoted, with quotes doubled. An empty value is an empty cell.

string

Examples

Answered, format=csv

result_id,ref,version,status,error,created_at,subject,text,team,team_probability,urgent,tone,tone_average
0192f5c1-7c1a-7b3e-9f55-3c1d2e4a5b6c,TCK-8812,3,ok,,2026-09-23T09:14:02.187Z,Charged twice this month,"Hi, I was billed twice for September. Please refund the second charge before Friday.",Billing,0.91,Yes,Annoyed,2.05

Failed, format=csv

result_id,ref,version,status,error,created_at,subject,text,team,team_probability,urgent,tone,tone_average
0192f5c3-2b4e-7d10-8a61-5e0f9c7d2a13,TCK-8812,3,failed,"The model took too long to answer, so we stopped after 15 seconds.",2026-09-23T09:15:40.502Z,Charged twice this month,"Hi, I was billed twice for September. Please refund the second charge before Friday.",,,,,

The csv columns, separated by tabs, with lines ending in LF. Tabs and line breaks inside a cell become spaces.

string

Examples

Answered, format=tsv

result_id  ref  version  status  error  created_at  subject  text  team  team_probability  urgent  tone  tone_average
0192f5c1-7c1a-7b3e-9f55-3c1d2e4a5b6c  TCK-8812  3  ok    2026-09-23T09:14:02.187Z  Charged twice this month  Hi, I was billed twice for September. Please refund the second charge before Friday.  Billing  0.91  Yes  Annoyed  2.05

Failed, format=tsv

result_id  ref  version  status  error  created_at  subject  text  team  team_probability  urgent  tone  tone_average
0192f5c3-2b4e-7d10-8a61-5e0f9c7d2a13  TCK-8812  3  failed  The model took too long to answer, so we stopped after 15 seconds.  2026-09-23T09:15:40.502Z  Charged twice this month  Hi, I was billed twice for September. Please refund the second charge before Friday.

One line ending in LF, holding the csv row as a JSON object, with option keys and yes, no or unsure instead of labels, and all columns as objects.

string

Examples

Answered, format=jsonl

{"result_id":"0192f5c1-7c1a-7b3e-9f55-3c1d2e4a5b6c","ref":"TCK-8812","version":3,"status":"ok","error":null,"created_at":"2026-09-23T09:14:02.187Z","subject":"Charged twice this month","text":"Hi, I was billed twice for September. Please refund the second charge before Friday.","team":"billing","team_probability":0.91,"urgent":"yes","tone":"annoyed","tone_average":2.05}

Failed, format=jsonl

{"result_id":"0192f5c3-2b4e-7d10-8a61-5e0f9c7d2a13","ref":"TCK-8812","version":3,"status":"failed","error":"The model took too long to answer, so we stopped after 15 seconds.","created_at":"2026-09-23T09:15:40.502Z","subject":"Charged twice this month","text":"Hi, I was billed twice for September. Please refund the second charge before Friday.","team":null,"team_probability":null,"urgent":null,"tone":null,"tone_average":null}

400

The result id or the format is invalid.

application/json; charset=utf-8

Every error has this body, in JSON, whatever format asked for.

object

error

required

object

code

required

validation_failed, bad_request, unauthorized, not_found, conflict or internal_error.

string

message

required

What went wrong, in words. A validation message names the failing paths and never repeats a value sent. Unknown fields lists the keys sent.

string

Examples

Result id is not a UUID

{
  "error": {
    "code": "validation_failed",
    "message": "Invalid request: result_id: Invalid uuid"
  }
}

Unknown format

{
  "error": {
    "code": "validation_failed",
    "message": "Invalid request: format: Expected 'json' | 'raw' | 'csv' | 'tsv' | 'jsonl'"
  }
}

401

No API key, or one that is unknown or revoked.

application/json; charset=utf-8

Every error has this body, in JSON, whatever format asked for.

object

error

required

object

code

required

validation_failed, bad_request, unauthorized, not_found, conflict or internal_error.

string

message

required

What went wrong, in words. A validation message names the failing paths and never repeats a value sent. Unknown fields lists the keys sent.

string

Examples

No Authorization header

{
  "error": {
    "code": "unauthorized",
    "message": "Authentication required"
  }
}

Unknown or revoked key

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

404

No result with this id in this account.

application/json; charset=utf-8

Every error has this body, in JSON, whatever format asked for.

object

error

required

object

code

required

validation_failed, bad_request, unauthorized, not_found, conflict or internal_error.

string

message

required

What went wrong, in words. A validation message names the failing paths and never repeats a value sent. Unknown fields lists the keys sent.

string

Examples

unknown_result

Unknown result

{
  "error": {
    "code": "not_found",
    "message": "Result not found"
  }
}

500

A bug on our side. The message is always the same.

application/json; charset=utf-8

Every error has this body, in JSON, whatever format asked for.

object

error

required

object

code

required

validation_failed, bad_request, unauthorized, not_found, conflict or internal_error.

string

message

required

What went wrong, in words. A validation message names the failing paths and never repeats a value sent. Unknown fields lists the keys sent.

string

Examples

unexpected_error

Unexpected error

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error"
  }
}