List and filter stations

Retrieve a paginated list of test stations in your organization. Search by station name and filter by status for station fleet management.

Access

API Key	Access Level	Description
User	Full	Users can read stations
Station	Unauthorized	Stations cannot read stations

Endpoint

GET/v2/stations

Authorization

AuthorizationBearer <token>

API key for authentication. Use format: Bearer YOUR_API_KEY

In: header

Query Parameters

limit?integer

Number of stations to return per page

Default50

Range1 <= value <= 100

cursor?integer

Cursor for pagination. Use the nextCursor from previous response

Range-9007199254740991 <= value <= 9007199254740991

search_query?string

Search query to filter stations by name

procedure_ids?array<string>

Filter stations by linked procedure IDs

Response Body

from tofupilot.v2 import TofuPilot

# Initialize the TofuPilot client
client = TofuPilot()

# Execute the operation
result = client.stations.list(
    limit=50,
    cursor=1,
    search_query="assembly",
    procedure_ids=["550e8400-e29b-41d4-a716-446655440000"]
)

# Handle response
print(result)

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Assembly Station 1",
      "procedures": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440001",
          "identifier": "PROC-001",
          "name": "Assembly Test"
        }
      ],
      "procedures_count": 5,
      "team": {
        "id": "550e8400-e29b-41d4-a716-446655440002",
        "name": "Assembly Team"
      }
    }
  ],
  "meta": {
    "has_more": true,
    "next_cursor": 2
  }
}

{
  "message": "Unauthorized",
  "code": "UNAUTHORIZED",
  "issues": []
}

{
  "message": "Internal server error",
  "code": "INTERNAL_SERVER_ERROR",
  "issues": []
}

How is this guide?