List institution work history

GET

/api/v1/institutions/{id}/work-history

Paginated list of completed contracts for the institution, filtered by tool_type and tool_brand
(case-insensitive exact match on stored contract fields).

Authorization: Bearer token. Caller must be institution, partner, or supervisor.
All of those roles receive the same result set: every completed contract for this institution that
matches tool_type and tool_brand (not restricted by which partner performed the work).

Both query parameters tool_type and tool_brand are required (non-blank). Sort order is newest completion first.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Query Params

Responses

🟢200

application/json

Work history retrieved successfully

Bodyapplication/json

🟠422

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/institutions/1/work-history?tool_type=MRI&tool_brand=Siemens&page=undefined&per_page=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "success": true,
    "data": [
        {
            "description": "Maintenance completed",
            "date": "2025-11-15",
            "tool_type": "MRI",
            "tool_brand": "Siemens"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 20,
        "total_count": 1,
        "total_pages": 1,
        "prev_page": null,
        "next_page": null
    }
}

Modified at 2026-06-08 00:59:16

Update institution

Get settings