Skip to main content
GET
/
api
/
public
/
v2
/
tables
/
{table_id}
/
sheets
/
{sheet_id}
/
versions
/
score-history
Get Table Sheet Score History
curl --request GET \
  --url https://api.promptlayer.com/api/public/v2/tables/{table_id}/sheets/{sheet_id}/versions/score-history \
  --header 'X-API-KEY: <api-key>'
{
  "success": true,
  "score_history": {
    "points": [
      {}
    ],
    "total_points": 123,
    "returned_points": 123,
    "range": "<string>",
    "max_points": 123,
    "is_sampled": true
  }
}
Retrieve score-history points across sheet versions. Use range to limit the history window (all, last_25, last_50, last_100, or last_250), resolution to control sampling (auto, raw, or min_max_bucket), and max_points to cap the number of returned points. max_points defaults to 1200 and must be between 50 and 5000.

Authorizations

​
X-API-KEY
string
header
required

Headers

​
X-API-KEY
string
required

Your PromptLayer API key. The key's workspace scopes table resources for this request.

Path Parameters

​
table_id
string<uuid>
required

Table ID.

​
sheet_id
string<uuid>
required

Table sheet ID.

Query Parameters

​
max_points
integer
default:1200

Maximum points to return.

Required range: 50 <= x <= 5000
​
range
enum<string>
default:all

History range.

Available options:
all,
last_25,
last_50,
last_100,
last_250
​
resolution
enum<string>
default:auto

Point resolution.

Available options:
auto,
raw,
min_max_bucket

Response

Successful response

​
success
boolean
required
​
score_history
object
required