---
title: "Retrieve PartyInteraction (Get Conversation Status)"
method: GET
path: "/partyInteraction/{id}"
tags: ["Tmf683PartyInteraction"]
---

# Retrieve PartyInteraction (Get Conversation Status)

`GET /partyInteraction/{id}`

## Request

- Base URL: `https://api.mtn.com/v1`
- URL: `https://api.mtn.com/v1/partyInteraction/{id}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.mtn.com/v1/oauth/access_token`
- TypeScript: <https://skmtc.dev/mtn/apis/tmf683-party-interaction/docs/partyInteraction/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the current status of an escalated conversation ticket from Y'ello Chat, including agent assignment and ticket lifecycle information. This endpoint enables clients to monitor whether a conversation is active, pending, assigned, resolved, or closed.

## Path parameters

- `id` string, required

## Headers

- `requestType` string
- `systemId` string
- `transactionId` string
- `x-country-code` string

## Response `200`

HTTP 200 indicating the request succeeded; the response body follows the documented schema for this operation and includes correlation identifiers where applicable for traceability across MTN MADAPI tmf683 party interaction flows.

- object
  - `id` string
  - `status` string
  - `interactionDate` object
    - `startDateTime` string
  - `statusChangeDate` string, date-time
  - `relatedParty` object[]
    - `role` string
    - `id` string
    - `@referredType` string
    - `@schemaLocation` string
    - `href` string
    - `name` string
    - `engagedParty` object
      - `id` string
      - `@referredType` string
      - `@schemaLocation` string
      - `href` string
    - `partyOrPartyRole` object
      - `id` string
      - `name` string
      - `@type` string
      - `@referredType` string
      - `href` string
  - `note` object[]
    - `id` string
    - `text` string
  - `externalIdentifier` object[]
    - `id` string
    - `owner` string
    - `externalIdentifierType` string

## Other responses

- `400`: Bad request. Invalid request parameters, missing required fields, or validation errors.
- `401`: Unauthorized. Invalid or missing authorization credentials, insufficient permissions, or authentication failure.
- `403`: Forbidden. Access denied. The request is valid but the server refuses to perform it.
- `404`: Not found. The requested resource was not found or does not exist.
- `500`: Internal server error. Unexpected system failure, database connectivity issues, or external service integration problems.
- `502`: Bad gateway. The server acting as a gateway received an invalid response from an upstream server.
- `503`: Service unavailable. The server is temporarily unable to handle the request due to maintenance or overload.

---

[API](https://skmtc.dev/mtn/apis/tmf683-party-interaction.md) - [All operations](https://skmtc.dev/mtn/apis/tmf683-party-interaction/llms.txt) - [OpenAPI document](https://skmtc.dev/mtn/apis/tmf683-party-interaction/revisions/6fe280d55cb2?raw)