> ## Documentation Index
> Fetch the complete documentation index at: https://api.scalysis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Call Outcome — GET /api/v1/orders/{orderId}/outcome

> Retrieve the outcome, transcript, cost, and summary of a completed AI call by passing the order ID returned when you triggered the call.

Once an AI call has finished, use this endpoint to fetch the full outcome for that call — including its completion status, duration, cost, a plain-language summary of what was discussed, and a timestamped transcript of the conversation. You identify the call using the `order_id` returned when you originally triggered it.

**Endpoint**

```text theme={null}
GET https://app.scalysis.com/api/v1/orders/{orderId}/outcome
```

**Authentication**

Include your API key in the request using either the `Authorization` header as a Bearer token or the `X-API-Key` header.

```text theme={null}
Authorization: Bearer <your_api_key>
```

```text theme={null}
X-API-Key: <your_api_key>
```

***

## Path Parameter

<ParamField path="orderId" type="number" required>
  The unique ID of the call record to look up. This is the `order_id` value returned in the response from [POST /api/v1/calls/trigger](/api-reference/calls/trigger).
</ParamField>

***

## Example Request

```bash theme={null}
curl --request GET \
  --url https://app.scalysis.com/api/v1/orders/1368642/outcome \
  --header 'Authorization: Bearer <your_api_key>'
```

***

## Response Fields

<ResponseField name="success" type="boolean">
  `true` when the outcome was successfully retrieved.
</ResponseField>

<ResponseField name="orderId" type="number">
  The order ID you requested, echoed back in the response.
</ResponseField>

<ResponseField name="orderNumber" type="string">
  The order or reference number you supplied when triggering the call, if any.
</ResponseField>

<ResponseField name="callStatus" type="string">
  The final status of the call (e.g. `"completed"`).
</ResponseField>

<ResponseField name="callDurationSec" type="number">
  Total duration of the call in seconds.
</ResponseField>

<ResponseField name="callOutcome" type="string">
  A short label describing the result of the call, such as `"Insufficient Talk"`, `"Confirmed"`, or `"Not Interested"`.
</ResponseField>

<ResponseField name="totalCallCost" type="number">
  The cost charged for this call, in your account's billing currency.
</ResponseField>

<ResponseField name="summary" type="string">
  A plain-language summary of the call, generated by the AI agent after the conversation ends.
</ResponseField>

<ResponseField name="transcript" type="array">
  An ordered list of turns in the conversation between the agent and the customer.

  <Expandable title="transcript item fields">
    <ResponseField name="speaker" type="string">
      Who spoke this turn — either `"agent"` or `"customer"`.
    </ResponseField>

    <ResponseField name="text" type="string">
      The spoken text for this turn, as transcribed from the call audio.
    </ResponseField>

    <ResponseField name="timestamp" type="number">
      The offset in milliseconds from the start of the call at which this turn began.
    </ResponseField>
  </Expandable>
</ResponseField>

***

## Example Success Response

```json theme={null}
{
  "success": true,
  "orderId": 1368642,
  "orderNumber": "demo-order-001",
  "callStatus": "completed",
  "callDurationSec": 13,
  "callOutcome": "Insufficient Talk",
  "totalCallCost": 1.0833,
  "summary": "Agent introduced themselves; customer asked for identity...",
  "transcript": [
    { "speaker": "agent", "text": "Hello...", "timestamp": 123 },
    { "speaker": "customer", "text": "Who is this?", "timestamp": 456 }
  ]
}
```

***

<Note>
  **Call still in progress?** If you request the outcome before the call has finished, the API returns a `404` with the message `"Call is still in progress"`. Wait **10–30 seconds** after triggering the call, then retry the request. For longer or complex conversations, allow more time before polling.
</Note>

<Note>
  **Recording URLs are not included.** The outcome response contains the transcript and summary only — direct audio recording URLs are not returned by this endpoint.
</Note>
