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.

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

1	from phonic import Phonic
2
3	client = Phonic(
4	api_key="YOUR_TOKEN_HERE",
5	)
6
7	client.conversations.evaluate(
8	id="id",
9	)

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	}