The Get Client Programs API retrieves the list of programs associated with the specified client. This API is used to fetch program records configured under a client within the QEval system.
| URL |
https://{Subdomain}.qevalpro.com/api/ManageUser/GetProgramnListByClientId |
| Method | POST |
| Sub Domains | “app” or “ai” |
1. API Headers
Every API call must include two-factor authentication by providing the following headers:
| Header | Type | Description |
|---|---|---|
| Authorisation | String | Bearer <Generated_Token> (generated after successful login) |
| X-API-KEY | String |
<Your_Unique_API_Key> (generated after successful login) Note: If unavailable, email Qeval@etechtexas.com. |
2. Sample Request (Payload)
Description for Request Parameters
| S.No | Name | Type | Description | Is Required? |
| 1 | ClientId | Integer | Client ID for which program records need to be retrieved. Use “0” to retrieve all accessible programs. | Yes |
3. Response Examples
Success
Status Codes
| Code | Status | Description |
| 200 | Success | Returns the list of programs successfully |
Response Parameters
| S.No | Name | Type | Description |
| 1 | Selected | Boolean | Indicates whether the program is selected by default |
| 2 | Text | String | Display name of the program |
| 3 | Value | String | Unique identifier of the program |
Failure
Status Codes
| Code | Status | Description |
| 401 | Unauthorised | Token missing, expired, or invalid |
| 403 | Forbidden | Invalid or missing API key |
| 406 | Not Acceptable | Exception occurred while processing the request |
| 500 | Internal Server Error | Unexpected server error occurred |
Notes
- Authentication is mandatory for accessing this API.
- The API returns programs associated with the specified client.
- Use ClientId = 0 to retrieve all accessible programs.
- The Text field represents the program name displayed in the application.
- The Value field represents the unique program identifier used in subsequent API requests.
- A successful response may contain one or more program records depending on the client configuration.
Video