Dec 2025 - New! Caching input tokens unlocks immediate, automatic ~30% credit savings on supported models
cURL
curl --request POST \ --url http://localhost:3000/api/admin/institutions \ --header 'Content-Type: application/json' \ --header 'x-access-token: <api-key>' \ --data ' { "minimum": true } '
{ "success": true, "data": [ { "_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 } ] }
Get a list of all institutions with their details and statistics
JWT token passed in x-access-token header
Whether to return minimal institution data
Successfully retrieved institutions list
Whether the request was successful
Array of institution objects
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
Account ID
Account name
Maximum completion tokens allowed
Total credits available
Percentage of credits used
Institution identifier
Whether to display agent details
Was this page helpful?