Get Answer

JavaScript

import Semilattice from 'semilattice';

const client = new Semilattice({
  apiKey: 'My API Key',
});

const answer = await client.answers.get('answer_id');

console.log(answer.data);

{
  "data": {
    "id": "b8b3e8cb-4c67-40d7-8350-3eac3c2b127d",
    "created_at": "2025-06-23T15:40:52Z",
    "population": "af8917b4-a09c-41f9-9c9f-c4c40c1f7415",
    "status": "Predicted",
    "population_name": "Developers",
    "question": "Tech debt or unclear error messages, what's worse?",
    "accuracy": 0.8528,
    "squared_error": 0.1607,
    "root_mean_squared_error": 0.1607,
    "simulated_answer_percentages": {
      "Tech debt": 0.5488,
      "Unclear error messages": 0.4512
    },
    "predicted_answer_percentages": {
      "Tech debt": 0.5488,
      "Unclear error messages": 0.4512
    },
    "information_loss": 0.0043,
    "normalised_information_loss": 0.051,
    "batch": "1e6bfe22-40d9-46c4-b241-9e1d7d5c5560",
    "prediction_started_at": "2025-06-23T15:41:02Z",
    "prediction_finished_at": "2025-06-23T15:43:56Z",
    "test_started_at": "2025-06-23T15:44:10Z",
    "test_finished_at": "2025-06-23T15:45:30Z",
    "ground_answer_counts": {
      "Tech debt": 58,
      "Unclear error messages": 42
    },
    "ground_answer_percentages": {
      "Tech debt": 0.58,
      "Unclear error messages": 0.42
    },
    "simulation_engine": "answers-1",
    "public": false,
    "answer_options": [
      "Tech debt",
      "Unclear error messages"
    ],
    "question_options": {
      "question_type": "single-choice"
    }
  },
  "errors": [
    {
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

GET

answers

{answer_id}

JavaScript

import Semilattice from 'semilattice';

const client = new Semilattice({
  apiKey: 'My API Key',
});

const answer = await client.answers.get('answer_id');

console.log(answer.data);

{
  "data": {
    "id": "b8b3e8cb-4c67-40d7-8350-3eac3c2b127d",
    "created_at": "2025-06-23T15:40:52Z",
    "population": "af8917b4-a09c-41f9-9c9f-c4c40c1f7415",
    "status": "Predicted",
    "population_name": "Developers",
    "question": "Tech debt or unclear error messages, what's worse?",
    "accuracy": 0.8528,
    "squared_error": 0.1607,
    "root_mean_squared_error": 0.1607,
    "simulated_answer_percentages": {
      "Tech debt": 0.5488,
      "Unclear error messages": 0.4512
    },
    "predicted_answer_percentages": {
      "Tech debt": 0.5488,
      "Unclear error messages": 0.4512
    },
    "information_loss": 0.0043,
    "normalised_information_loss": 0.051,
    "batch": "1e6bfe22-40d9-46c4-b241-9e1d7d5c5560",
    "prediction_started_at": "2025-06-23T15:41:02Z",
    "prediction_finished_at": "2025-06-23T15:43:56Z",
    "test_started_at": "2025-06-23T15:44:10Z",
    "test_finished_at": "2025-06-23T15:45:30Z",
    "ground_answer_counts": {
      "Tech debt": 58,
      "Unclear error messages": 42
    },
    "ground_answer_percentages": {
      "Tech debt": 0.58,
      "Unclear error messages": 0.42
    },
    "simulation_engine": "answers-1",
    "public": false,
    "answer_options": [
      "Tech debt",
      "Unclear error messages"
    ],
    "question_options": {
      "question_type": "single-choice"
    }
  },
  "errors": [
    {
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

Headers

authorization

string

Path Parameters

answer_id

string

required

ID of the prediction you want to fetch.

Response

Successful Response

data

AnswersResponse · object

The primary response payload. Contains the result of the request if successful.

Show child attributes

data.id

string<uuid4>

required

Question ID

Example:

"b8b3e8cb-4c67-40d7-8350-3eac3c2b127d"

data.created_at

string<date-time>

required

When the question was created

Example:

"2025-06-23T15:40:52Z"

data.population

string<uuid4>

required

Population ID

Example:

"af8917b4-a09c-41f9-9c9f-c4c40c1f7415"

data.status

string

required

Current status

Example:

"Predicted"

data.population_name

string

required

Name of the population

Example:

"Developers"

data.question

string

required

Full text of the question

Example:

"Tech debt or unclear error messages, what's worse?"

data.accuracy

number | null

required

Accuracy for this prediction. Calculated as inverse mean absolute error (1 - MAE)

Example:

0.8528

data.squared_error

number | null

required

Squared error for this prediction. Calculated as root mean squared error (RMSE)

Example:

0.1607

data.root_mean_squared_error

number | null

required

deprecated

Squared error for this prediction. Calculated as root mean squared error (RMSE)

Example:

0.1607

data.simulated_answer_percentages

required

deprecated

Simulated answer percentages keyed by answer option

Example:

{
  "Tech debt": 0.5488,
  "Unclear error messages": 0.4512
}

data.predicted_answer_percentages

required

Predicted answer percentages keyed by answer option

Example:

{
  "Tech debt": 0.5488,
  "Unclear error messages": 0.4512
}

data.information_loss

number | null

required

Information loss between predicted and ground-truth distributions. Calculated as Kullback-Leibler (KL) divergence (entropy). Cannot be used to compare different predictions.

Example:

0.0043

data.normalised_information_loss

number | null

required

Information loss between predicted and ground-truth distributions normalised to the number of answer options. Calculated as the normalised Kullback-Leibler (KL) divergence (entropy).

Example:

0.051

data.batch

string<uuid4> | null

ID shared by all tests or predictions in a batch run

Example:

"1e6bfe22-40d9-46c4-b241-9e1d7d5c5560"

data.prediction_started_at

string<date-time> | null

When prediction began

Example:

"2025-06-23T15:41:02Z"

data.prediction_finished_at

string<date-time> | null

When prediction finished

Example:

"2025-06-23T15:43:56Z"

data.test_started_at

string<date-time> | null

When test began

Example:

"2025-06-23T15:44:10Z"

data.test_finished_at

string<date-time> | null

When test finished

Example:

"2025-06-23T15:45:30Z"

data.ground_answer_counts

Ground-truth answer counts (benchmark mode only)

Example:

{
  "Tech debt": 58,
  "Unclear error messages": 42
}

data.ground_answer_percentages

Ground-truth answer percentages (benchmark mode only)

Example:

{
  "Tech debt": 0.58,
  "Unclear error messages": 0.42
}

data.simulation_engine

string | null

Engine used (e.g. answers-1)

Example:

"answers-1"

data.public

boolean | null

If the question is public

Example:

false

data.answer_options

any[] | null

Answer options presented to the model (single/ multi-choice)

Example:

["Tech debt", "Unclear error messages"]

data.question_options

Per-question configuration - see SimulationQuestionOptions and PopulationQuestionOptions schemas

Example:

{ "question_type": "single-choice" }

errors

ErrorResponse · object[] | null

List of structured error messages, if any occurred during the request.

Show child attributes

errors.code

string

required

Machine-readable error code

errors.message

string

required

Human-readable error message

Test Population Simulate Answer

⌘I

Populations

Answers

Predictions

Tests

Headers

Path Parameters

Response