Get a recipient

GEThttps://api.voice-agent.gowajee.ai/api/recipient/:recipientId

Returns one recipient. Get recipient IDs from List campaign recipients or from calls[].recipient.id in List campaign calls.

Path parameters

Name	Description
recipientId	The recipient ID.

Request

cURL

curl "https://api.voice-agent.gowajee.ai/api/recipient/5b1f0c9e-2d4a-4f6b-9a61-3c7e8d2f1a04" \
  -H "X-API-Key: $GOWAJEE_API_KEY"

JavaScript

const res = await fetch(`https://api.voice-agent.gowajee.ai/api/recipient/${recipientId}`, {
  headers: { 'X-API-Key': process.env.GOWAJEE_API_KEY },
});

Python

res = requests.get(
    f"https://api.voice-agent.gowajee.ai/api/recipient/{recipient_id}",
    headers={"X-API-Key": os.environ["GOWAJEE_API_KEY"]},
    timeout=30,
)

Response

200 OK

{
  "success": true,
  "message": "Get Recipient details successfully",
  "data": {
    "id": "5b1f0c9e-2d4a-4f6b-9a61-3c7e8d2f1a04",
    "customerName": "Somchai",
    "tel": "0812345678",
    "callAttempt": 2,
    "latestCallStatus": "COMPLETED",
    "agentParams": { "customer_name": "Somchai", "amount_due": 1500 },
    "campaignId": "eac2489c-672c-455e-ab8c-4e0ecd18d7dc",
    "createdAt": "2026-09-30T08:12:44.120Z",
    "updatedAt": "2026-10-01T03:20:11.004Z",
    "personalDataMasked": false
  }
}

404 Not Found

{
  "success": false,
  "statusCode": 404,
  "code": "RECIPIENT_NOT_FOUND",
  "message": "Recipient not found",
  "errors": ["Recipient not found"]
}

The fields are the same as in List campaign recipients.

Errors

The body is the usual error envelope.

Status	code	message	Cause
400	INVALID_ID	recipientId must be a valid UUID	The ID in the path isn’t a UUID.
404	RECIPIENT_NOT_FOUND	Recipient not found	Wrong ID, or the recipient belongs to another organization.