Evaluate | Phonic

Evaluates a conversation using an evaluation prompt.

AuthorizationBearer

Bearer authentication header of the form Bearer <PHONIC_API_KEY>. Manage your API keys here.

Bearer authentication header of the form `Bearer <PHONIC_API_KEY>`. Manage your API keys [here](https://phonic.co/api-keys).

idstringRequired

The ID of the conversation to evaluate.

This endpoint expects an object.

prompt_idstringRequired

ID of the evaluation prompt to use.

Success response

idstring

The evaluation ID.

resultenum

The evaluation result.

Allowed values:

promptobject

The evaluation prompt information.

created_atstringformat: "date-time"

When the evaluation was created.

1	from phonic import Phonic
2
3	client = Phonic(
4	base_url="https://api.phonic.co/v1",
5	api_key="YOUR_TOKEN_HERE"
6	)
7
8	client.conversations.evaluate(
9	id="id"
10	)

1	{
2	"id": "conv_eval_12345678-abcd-efgh-ijkl-mnopqrstuvwx",
3	"result": "successful",
4	"prompt": {
5	"id": "conv_eval_prompt_d7cfe45d-35db-4ef6-a254-81ab1da76ce0",
6	"name": "chocolate_usage"
7	},
8	"created_at": "2025-07-30T23:49:18.130Z"
9	}