List evaluator versions

List all versions of an evaluator, ordered newest first. Version 0 is the initial draft; committed versions are returned with is_read_only: true.

get/api/evaluators/{evaluator_id}/versions/

Path parameters

evaluator_idstring required

Evaluator ID. To run a specific version, pass an ID with a version suffix where supported, for example evl_abc123:2.

Query parameters

pageinteger

Page number.

page_sizeinteger

Number of results to return per page. Maximum 100.

Headers

Authorizationstring required

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Response

Paginated evaluator versions.

countinteger required

Number of resources returned on this page.

nextstring nullable

URL for the next page, if any.

previousstring nullable

URL for the previous page, if any.

current_filtersApiEvaluatorsEvaluatorIdVersionsGetResponsesContentApplicationJsonSchemaCurrentFilters

Normalized filters applied to this request.

Changes

Changed in 3 of the 6 revisions of this API.171224

Aug 22, 2026b18c729750973See the full diff
- ●
  for the query request parameter page_size, the max was set to 100.00
  request-parameter-max-set
- ●
  for the query request parameter page, the min was set to 1.00
  request-parameter-min-set
- ●
  for the query request parameter page_size, the min was set to 1.00
  request-parameter-min-set
Aug 13, 20264e064cf81dae8314See the full diff
- ▲
  the response property results/items/description became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property results/items/created_at became optional for the status 200
  response-property-became-optional
- ▲
  the response property results/items/created_by became optional for the status 200
  response-property-became-optional
- ▲
  the response property results/items/created_by/email became optional for the status 200
  response-property-became-optional
- ▲
  the response property results/items/created_by/id became optional for the status 200
  response-property-became-optional
- ▲
  the next response's property type/format changed from string null/uri to string null/ for status 200
  response-property-type-changed
- ▲
  the previous response's property type/format changed from string null/uri to string null/ for status 200
  response-property-type-changed
- ▲
  removed the required property results/items/created_by/name from the response with the 200 status
  response-required-property-removed
- ●
  removed the optional property filters_data from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property results/items/created_by/username from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property total_count from the response with the 200 status
  response-optional-property-removed
- ○
  added the non-success response with the status 401
  response-non-success-status-added
- ○
  added the non-success response with the status 404
  response-non-success-status-added
- ○
  the response property results/items/id became required for the status 200
  response-property-became-required
- ○
  the response property results/items/is_read_only became required for the status 200
  response-property-became-required
- ○
  the response property results/items/score_value_type became required for the status 200
  response-property-became-required
- ○
  the response property results/items/type became required for the status 200
  response-property-became-required
- ○
  the response property results/items/version became required for the status 200
  response-property-became-required
- ○
  the response property results/items/version_id became required for the status 200
  response-property-became-required
- ○
  removed the custom enum value from the results/items/type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the function enum value from the results/items/type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the human_boolean enum value from the results/items/type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the human_categorical enum value from the results/items/type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the human_numerical enum value from the results/items/type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the human_text enum value from the results/items/type response property for the response status 200
  response-property-enum-value-removed
This revision also has 1490 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 31, 2026c26d550029f89610See the full diff
- ▲
  the response property results/items/id became optional for the status 200
  response-property-became-optional
- ▲
  the response property results/items/is_read_only became optional for the status 200
  response-property-became-optional
- ▲
  the response property results/items/score_value_type became optional for the status 200
  response-property-became-optional
- ▲
  the response property results/items/type became optional for the status 200
  response-property-became-optional
- ▲
  the response property results/items/version became optional for the status 200
  response-property-became-optional
- ▲
  the response property results/items/version_id became optional for the status 200
  response-property-became-optional
- ▲
  the next response's property type/format changed from string null/ to string null/uri for status 200
  response-property-type-changed
- ▲
  the previous response's property type/format changed from string null/ to string null/uri for status 200
  response-property-type-changed
- ▲
  the results/items/created_by/email response's property type/format changed from string/email to string/ for status 200
  response-property-type-changed
- ●
  added the new custom enum value to the results/items/type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new function enum value to the results/items/type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new human_boolean enum value to the results/items/type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new human_categorical enum value to the results/items/type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new human_numerical enum value to the results/items/type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new human_text enum value to the results/items/type response property for the response status 200
  response-property-enum-value-added
- ○
  removed the non-success response with the status 401
  response-non-success-status-removed
- ○
  removed the non-success response with the status 404
  response-non-success-status-removed
- ○
  added the optional property filters_data to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/created_by/username to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property total_count to the response with the 200 status
  response-optional-property-added
- ○
  the response property results/items/created_at became required for the status 200
  response-property-became-required
- ○
  the response property results/items/created_by became required for the status 200
  response-property-became-required
- ○
  the response property results/items/created_by/email became required for the status 200
  response-property-became-required
- ○
  the response property results/items/created_by/id became required for the status 200
  response-property-became-required
- ○
  added the required property results/items/created_by/name to the response with the 200 status
  response-required-property-added
This revision also has 1158 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history