---
title: "Retrieve all scorecards"
slug: "retrieve-scorecards-details-v2settingsscorecards"
updated: 2025-11-17T08:10:53Z
published: 2025-11-17T08:12:09Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.gong.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve scorecards details (/v2/settings/scorecards)

Get/v2/settings/scorecards

Retrieve all the scorecards within the Gong system.

Required authorizaton scope: 'api:settings:scorecards:read'.

Responses200

Successful response

<select class='api-response-data' aria-label='Media type'><option value='68e406a1-6277-4179-bee4-012f60ff397b'>application/json</option>
</select>Expand Allobject  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
scorecards Array of object (Scorecard)   

A list, in which each item contains one scorecard.

object  

A list, in which each item contains one scorecard.

scorecardIdinteger  (int64)    

The identifier of the scorecard.

Example6843152929075440000
scorecardNamestring    

Scorecard name.

ExampleSDR Call Scorecard
workspaceIdinteger  (int64)    

Scorecard workspaceId.

Example623457276584334
enabledboolean    

If the scorecard is enabled or not.

Exampletrue
updaterUserIdinteger  (int64)    

The user Id of the team member that updated the scorecard.

Example234599484848423
createdstring  (date-time)    

The date and time when the scorecard was created in the ISO-8601 format, for example: '2024-01-17T16:20:05-03:00' or '2016-02-16T03:57:04.834+05:30' or '2020-11-20T21:30:07.233692Z', where Z stands for UTC.

Example2018-02-17T10:30:00Z
updatedstring  (date-time)    

The date and time when the scorecard was updated in the ISO-8601 format, for example: '2024-01-17T16:20:05-03:00' or '2016-02-16T03:57:04.834+05:30' or '2020-11-20T21:30:07.233692Z', where Z stands for UTC.

Example2018-02-19T10:30:00Z
reviewMethodstring    

The method used to review the scorecard.

Valid values[
  "AUTOMATIC",
  "MANUAL"
]
questions Array of object (Question)   

The questions in the scorecard.

object  

The questions in the scorecard.

questionIdinteger  (int64)    

The identifier for the question.

questionRevisionIdinteger  (int64)    

The identifier for the revision version of the question.

Example43955224753211110
questionTextstring    

The question's text.

ExampleHow do you evaluate the SDR's overall performance in the call?
isOverallboolean    

If the question is the main overall question.

Examplefalse
questionTypestring    

The type of question.

ExampleRANGE
answerGuidestring    

The guide for answering the question.

ExampleAnswer is in the small talk
minRangeinteger  (int32)    

The minimum value that can be selected in the answer. Null for questions with no range.

Example0
maxRangeinteger  (int32)    

The maximum value that can be selected in the answer. Null for questions with no range.

Example50
answerOptions Array of object (QuestionOption)   

The answer options in case of multi-select or single-select type question. Null otherwise.

object  

The answer options in case of multi-select or single-select type question. Null otherwise.

idinteger  (int32)    

The identifier of the option.

Example1
textstring    

The option’s text.

ExampleThe SDR did not mention the product

400

Malformed request

<select class='api-response-data' aria-label='Media type'><option value='bd2d3eed-039f-42db-9e21-2c6a07dc5ce5'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

401

Access denied

<select class='api-response-data' aria-label='Media type'><option value='ce516c33-4bd3-4297-9665-23b80acd5461'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

404

Scorecards not found

<select class='api-response-data' aria-label='Media type'><option value='9100ae6e-39b7-4d04-b041-6e7b2139907d'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

429

API request limit exceeded

HeadersRetry-AfterintegerNumber of seconds to wait before making a new request.
<select class='api-response-data' aria-label='Media type'><option value='9bef31a4-bc18-4f94-85e6-d796200b54bd'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

500

Failed to complete the operation due to an unexpected error

<select class='api-response-data' aria-label='Media type'><option value='5ae0d744-5c65-4d2b-bc64-a4c2498181e4'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string