List services | StatusGator Octri Preview

3 parameters

pageintegeroptional

Page number for pagination (default: 1)

per_pageintegeroptional

Number of items per page (default: 25, max: 100)

created_afterstringoptional

Filter services created after this timestamp (ISO 8601 format)

4 status codes

200services filtered by created_after

dataarray<object>optional

paginationobjectoptional

successbooleanoptional

400bad request - invalid created_after format

401unauthorized

403forbidden - no Firehose access

Error handling

A 400 is returned: bad request - invalid created_after format. A 401 is returned: unauthorized. A 403 is returned: forbidden - no Firehose access.

import (
	"context"
	"fmt"
	"log"
	"os"

	statusgatoroctripreview "github.com/statusgator_octri_preview_sdk/sdk"
)

ctx := context.Background()
client := statusgatoroctripreview.NewStatusGator(statusgatoroctripreview.ClientConfig{
	BaseURL: "https://{defaultHost}/api/v3",
	Auth: &statusgatoroctripreview.ClientAuthConfig{BearerAuth: os.Getenv("API_TOKEN")},
})

result, err := client.Services.List(
	ctx,
	statusgatoroctripreview.ListServicesParams{},
)
if err != nil {
	log.Fatal(err)
}
fmt.Println(result)

{
  "data": [
    {
      "category_names": [
        "Development Tools",
        "Version Control"
      ],
      "created_at": "2025-09-12T12:35:54Z",
      "description": "GitHub is a web-based version control and collaboration platform for software developers.",
      "home_page_url": "https://github.com",
      "icon_url": "https://statusgator.com/favicons/github.png",
      "id": "k2x9m7nPqR",
      "landing_page_url": "https://statusgator.com/services/github",
      "name": "GitHub",
      "official": true,
      "public_url": "https://www.githubstatus.com/",
      "rating": {
        "average_delay_minutes": 8.3,
        "description": "Excellent",
        "letter_grade": "A"
      },
      "updated_at": "2025-09-12T12:40:54Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "next_page": 1,
    "per_page": 1,
    "prev_page": 1,
    "total_count": 42,
    "total_pages": 42
  },
  "success": true
}

Request

Response

Errors