---
title: "Get TCN Call Outcome"
method: GET
path: "/tcn/call-outcome/{tcn-cid}"
---

# Get TCN Call Outcome

`GET /tcn/call-outcome/{tcn-cid}`

## Request

- Base URL: `https://collectwiseapi.com`
- URL: `https://collectwiseapi.com/tcn/call-outcome/{tcn-cid}`
- Auth: API key in header `collectwise_key`

Retrieves the call outcome for a specific TCN call ID. This endpoint is designed to support TCN's SIP integration where calls are routed to CollectWise AI agents.

## Path parameters

- `tcn-cid` string, required

## Headers

- `x-cw-timestamp` string
- `x-cw-signature` string

## Response `200`

Call outcome found and returned

- TCNCallOutcome
  - `action` 'end' | 'judge_transfer' | 'garnishment_transfer' | 'general_transfer', required: The action to be taken based on the call outcome
  - `tcn_cid` string, required: The TCN call identifier
  - `timestamp` string, date-time, required: Timestamp when the call outcome was determined
  - `language` string, nullable: The language used during the call (e.g., 'english', 'spanish'). May be null if not provided.
  - `rpc` boolean, nullable: Whether right-party contact (identity verification) was completed during the call. Always null for integrations that do not report verification.

## Other responses

- `400`: Invalid or missing TCN CID parameter
- `403`: Invalid or missing API key
- `404`: Call outcome not found (call in progress or not available)
- `429`: Your organization's shared rate limit has been exceeded. Wait at least the number of seconds specified in Retry-After before retrying.
- `500`: Internal server error

## Changes

- **2026-11-03** `95fad0d2f369`: 4 info
  - added the new optional `header` request parameter `x-cw-signature`
  - added the new optional `header` request parameter `x-cw-timestamp`
  - added the non-success response with the status `429`
  - added the optional property `rpc` to the response with the `200` status

[Operation history](https://skmtc.dev/collectwise/apis/collectwise-api/changes/tcn/call-outcome/:tcn-cid/get.md)

---

[API](https://skmtc.dev/collectwise/apis/collectwise-api.md) - [All operations](https://skmtc.dev/collectwise/apis/collectwise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/collectwise/apis/collectwise-api/revisions/95fad0d2f369?raw)
