Dec 2025 - New! Caching input tokens unlocks immediate, automatic ~30% credit savings on supported models
curl --request POST \
--url http://localhost:3000/api/admin/institutionQuestions \
--header 'Content-Type: application/json' \
--header 'x-access-token: <api-key>' \
--data '
{
"institution": "<string>",
"minimum": true
}
'{
"success": true,
"data": [
{
"_id": "<string>",
"question": {
"_id": "<string>",
"code": "<string>",
"question": "<string>",
"objectif": "<string>",
"required": true,
"status": "<string>",
"position": 123,
"created": "2023-11-07T05:31:56Z",
"section": 123,
"mbti": true
},
"institution": {
"_id": "<string>",
"name": "<string>",
"picture": "<string>",
"credits": 123,
"creditsUsed": 123,
"creditsAwarded": 123,
"status": "active",
"publicId": "<string>",
"publicAuthorizedUrls": [
"<string>"
],
"ainame": "<string>",
"contactEmail": "<string>",
"poolCredits": true,
"created": "2023-11-07T05:31:56Z",
"conversationModel": "<string>",
"account": {
"_id": "<string>",
"name": "<string>"
},
"maxCompletionTokens": 123,
"creditsTotal": 123,
"creditsUsagePct": 123,
"id": "<string>",
"displayAgentDetails": true
},
"answer": "<string>",
"created": "2023-11-07T05:31:56Z"
}
]
}Get questions associated with a specific institution, with option for minimum data
curl --request POST \
--url http://localhost:3000/api/admin/institutionQuestions \
--header 'Content-Type: application/json' \
--header 'x-access-token: <api-key>' \
--data '
{
"institution": "<string>",
"minimum": true
}
'{
"success": true,
"data": [
{
"_id": "<string>",
"question": {
"_id": "<string>",
"code": "<string>",
"question": "<string>",
"objectif": "<string>",
"required": true,
"status": "<string>",
"position": 123,
"created": "2023-11-07T05:31:56Z",
"section": 123,
"mbti": true
},
"institution": {
"_id": "<string>",
"name": "<string>",
"picture": "<string>",
"credits": 123,
"creditsUsed": 123,
"creditsAwarded": 123,
"status": "active",
"publicId": "<string>",
"publicAuthorizedUrls": [
"<string>"
],
"ainame": "<string>",
"contactEmail": "<string>",
"poolCredits": true,
"created": "2023-11-07T05:31:56Z",
"conversationModel": "<string>",
"account": {
"_id": "<string>",
"name": "<string>"
},
"maxCompletionTokens": 123,
"creditsTotal": 123,
"creditsUsagePct": 123,
"id": "<string>",
"displayAgentDetails": true
},
"answer": "<string>",
"created": "2023-11-07T05:31:56Z"
}
]
}JWT token passed in x-access-token header
Successfully retrieved institution questions
Whether the request was successful
Array of institution questions
Show child attributes
Unique identifier for the institution question
Show child attributes
Unique identifier for the question
Question code identifier
The actual question text
Objective or purpose of the question
Whether the question is required
Status of the question (active/inactive)
Position order of the question
Creation timestamp
Section number the question belongs to
Whether question is related to MBTI assessment
Show child attributes
Institution ID
Institution name
Institution picture URL
Available credits for the institution
Number of credits used
Credits awarded to the institution
Institution status
active, inactive Public identifier for the institution
List of authorized URLs for the institution
AI name for the institution
Contact email for the institution
Whether credits are pooled
Institution creation timestamp
AI conversation model used
Maximum completion tokens allowed
Total credits available
Percentage of credits used
Institution identifier
Whether to display agent details
Answer to the question
Creation timestamp
Was this page helpful?