List Outputs

Hand off to an LLM

List terminal non-error output events.

Returns events that represent successful terminal outputs — primary events (non-split-collection) that did not trigger any downstream function calls. Error events are excluded; use GET /v3/errors to retrieve those.

Intermediate Events

By default, intermediate events (those that spawned a downstream function call in a multi-step workflow) are excluded. Pass includeIntermediate=true to include them.

Filtering

Filter by call, workflow, function, or reference ID. Multiple filters are ANDed together.

GET
/v3/outputs
x-api-key<token>

Authenticate using API Key in request header

In: header

Query Parameters

limit?integer
Default50
Range1 <= value <= 100
callIDs?array<>

Filter to outputs from specific calls.

Items1 <= items
workflowIDs?array<>
Items1 <= items
workflowNames?array<>
Items1 <= items
functionIDs?array<>
Items1 <= items
functionNames?array<>
Items1 <= items
referenceIDs?array<>
Items1 <= items
eventIDs?array<>

Filter to specific output events by their event IDs (KSUIDs).

Items1 <= items
transformationIDs?array<>

Filter by legacy transformation IDs. Provided for backwards compatibility with clients migrating from /v1-beta/transformations.

Items1 <= items
functionVersionNums?array<>

Filter to specific function version numbers.

Items1 <= items
referenceIDSubstring?string

Case-insensitive substring match against referenceID.

isLabelled?boolean

If true, only outputs with a corrected (labelled) payload. If false, only outputs that are not labelled. If omitted, no filter is applied.

isRegression?boolean

If true, only regression-marked outputs. If false, only non-regression outputs. If omitted, no filter is applied.

Note: clients migrating from /v1-beta/transformations should pass isRegression=false explicitly to preserve the legacy default (regressions hidden unless explicitly requested).

includeIntermediate?boolean

When true, includes intermediate events (those that spawned a downstream function call). Default: false.

sortOrder?string
Default"asc"
Value in"asc" | "desc"
startingAfter?string
endingBefore?string

Response Body

application/json

curl -X GET "https://api.bem.ai/v3/outputs"
{
  "outputs": [
    {
      "functionCallTryNumber": 0,
      "eventID": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "referenceID": "string",
      "inboundEmail": {
        "to": "string",
        "deliveredTo": "string",
        "from": "string",
        "subject": "string"
      },
      "metadata": {
        "durationFunctionToEventSeconds": 0
      },
      "eventType": "transform",
      "functionCallID": "string",
      "functionID": "string",
      "functionName": "string",
      "functionVersionNum": 0,
      "callID": "string",
      "workflowID": "string",
      "workflowName": "string",
      "workflowVersionNum": 0,
      "pipelineID": "string",
      "publishedAt": "2019-08-24T14:15:22Z",
      "lastPublishErrorAt": "string",
      "inputType": "csv",
      "transformationID": "string",
      "s3URL": "string",
      "inputs": [
        {
          "inputType": "string",
          "inputContent": "string",
          "jsonInputContent": {},
          "s3URL": "string"
        }
      ],
      "transformedContent": {},
      "correctedContent": {
        "output": [
          {}
        ]
      },
      "invalidProperties": [
        "string"
      ],
      "metrics": {
        "metrics": {
          "accuracy": 0,
          "precision": 0,
          "recall": 0,
          "f1Score": 0
        },
        "differences": [
          {
            "category": "string",
            "correctedVal": null,
            "extractedVal": null,
            "jsonPointer": "string"
          }
        ]
      },
      "orderMatching": true,
      "isRegression": true,
      "itemOffset": 0,
      "itemCount": 0,
      "fieldConfidences": {},
      "avgConfidence": 0.1
    }
  ],
  "totalCount": 0
}

See also