Pages
Endpoints for managing and retrieving status page profiles and status data.
List All Pages
Retrieve a list of all status pages associated with your account.
HTTP Method & URL: GET /pages
Request
- Headers
- cURL
| Name | Value | Required | Description |
|---|---|---|---|
Accept | application/json | Yes | Expected response format. |
curl -X GET "https://stg.itechops.com/api/pages" \
-H "Accept: application/json"
Responses
- 200 OK
- 500 Server Error
Description: Success. Returns a list of pages.
Response Body: List<PageModel>
[
{
"StatusPageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"Name": "Production Status Page",
"Url": "https://status.example.com",
"IsActive": true,
"IsPublic": true,
"IsDefault": true,
"IsRestricted": false,
"IsLayoutPlublished": true
}
]
Description: Internal server error.
Private Status
Retrieve private status page data.
HTTP Method & URL: GET /api/StatusPage/private
Authorization: Requires X-API-KEY
Request
- Headers
- cURL
| Name | Value | Required | Description |
|---|---|---|---|
X-API-KEY | string | Yes | Your unique API key. |
curl -X GET "https://stg.itechops.com/api/StatusPage/private" \
-H "X-API-KEY: your_api_key_here"
Responses
- 200 OK
- 400 Bad Request
- 401 Unauthorized
- 500 Server Error
Description: Success. Returns private status data.
Response Body: ApiResponse<StatusPageResponseModel>
Description: Error in request.
Description: Missing or invalid API key.
Description: Internal server error.
Audience Specific Status
Retrieve status page data for a specific audience.
HTTP Method & URL: GET /api/StatusPage/audience-specific/{guid}
Request
- Parameters
- cURL
guid: (Guid) The unique ID of the audience.userId: (Optional Guid) The ID of the user.
curl -X GET "https://stg.itechops.com/api/StatusPage/audience-specific/3fa85f64-5717-4562-b3fc-2c963f66afa0?userId=3fa85f64-5717-4562-b3fc-2c963f66afb1"
Responses
- 200 OK
- 403 Forbidden
- 500 Server Error
Description: Success.
Response Body: ApiResponse<StatusPageResponseModel>
Description: Access denied for this audience.
Description: Internal server error.
Check Access
Check if a user has access to a specific status page.
HTTP Method & URL: GET /api/StatusPage/{pageName}/check-access
Responses
- 200 OK
- 404 Not Found
- 500 Server Error
Description: Success. Returns access status.
{
"IsActive": true,
"IsPublic": true,
"HasAccess": true
}
Description: Page not found.
Description: Internal server error.
Active Announcements
Retrieve all currently active announcements.
HTTP Method & URL: GET /api/StatusPage/ActiveAnnouncement
Responses
- 200 OK
- 400 Bad Request
- 500 Server Error
Description: Success. Returns a list of active incidents/announcements.
Response Body: ApiResponse<List<IncidentInfo>>
Description: Bad request.
Description: Internal server error.
Incident History (Search)
Retrieve incident history with filters.
HTTP Method & URL: POST /api/StatusPage/statushistory
Request
- Payload
- cURL
Body: IncidentHistorySearchModel
curl -X POST "https://stg.itechops.com/api/StatusPage/statushistory" \
-H "Content-Type: application/json" \
-d '{
"PageName": "Production",
"SearchText": "Database"
}'
Responses
- 200 OK
- 400 Bad Request
- 500 Server Error
Description: Success. Returns incident history.
Response Body: ApiResponse<StatusPageIncidentHistoryResponseModel>
Description: Error in search parameters.
Description: Internal server error.
Uptime Data by Date
Retrieve uptime statistics for a specific date range.
HTTP Method & URL: POST /api/StatusPage/getUptimeDataByDate
Request
- Payload
Body: DateRequest
Days: (Int) Number of days of data to retrieve.
{
"Days": 90
}
Responses
- 200 OK
- 500 Server Error
Description: Success. Returns uptime data.
Description: Internal server error.
Uptime Reports
Generate detailed uptime reports.
HTTP Method & URL: POST /api/StatusPage/GetUptimeReports
Request
- Headers
- Payload
- cURL
| Name | Value | Required | Description |
|---|---|---|---|
Content-Type | application/json | Yes | Sending JSON data. |
Body: ReportsModel
{
"Components": ["3fa85f64-5717-4562-b3fc-2c963f66afa0"],
"Range": "Last30Days"
}
curl -X POST "https://stg.itechops.com/api/StatusPage/GetUptimeReports" \
-H "Content-Type: application/json" \
-d '{
"Components": ["3fa85f64-5717-4562-b3fc-2c963f66afa0"],
"Range": "Last30Days"
}'
Responses
- 200 OK
- 400 Bad Request
- 500 Server Error
Description: Success. Returns detailed uptime metrics.
Response Body: ApiResponse<ReportsModel>
Description: Invalid parameters provided.
Description: Internal server error.