Retrieve a list of teams with optional filtering.
External DocumentationTo learn more, visit the FireHydrant documentation.

​
Basic Parameters

ParameterDescription
NameFilter teams by their name.
PageThe page number to show results from.
Per PageMaximum number of results to return.
QueryFilter teams by their name or description.
ServicesA comma-separated list of service IDs to filter teams by.

​
Advanced Parameters

ParameterDescription
Default Incident RoleFilter by teams that have or do not have members with a default incident role assigned. Value may be ‘present’, ‘blank’, or the ID of an incident role.
SimplifySelect in order to return a simplified version of the teams object.

​
Example Output

{
	"data": [
		{
			"id": "string",
			"name": "string",
			"description": "string",
			"slug": "string",
			"created_at": "2025-07-16T09:20:11.089Z",
			"updated_at": "2025-07-16T09:20:11.089Z",
			"signals_ical_url": "string",
			"created_by": {
				"id": "string",
				"name": "string",
				"source": "string",
				"email": "string"
			},
			"in_support_hours": true,
			"slack_channel": {
				"id": "string",
				"name": "string",
				"slack_channel_id": "string"
			},
			"ms_teams_channel": {
				"id": "string",
				"channel_id": "string",
				"channel_name": "string",
				"ms_team_id": "string",
				"team_name": "string",
				"channel_url": "string",
				"status": "string",
				"incident": {
					"id": "string",
					"name": "string",
					"created_at": "2025-07-16T09:20:11.089Z",
					"started_at": "2025-07-16T09:20:11.089Z",
					"discarded_at": "2025-07-16T09:20:11.089Z",
					"summary": "string",
					"customer_impact_summary": "string",
					"description": "string",
					"current_milestone": "string",
					"number": 0,
					"priority": "string",
					"severity": "string",
					"severity_color": "string",
					"severity_impact": "string",
					"severity_condition": "string",
					"tag_list": [
						"string"
					],
					"incident_type": {
						"id": "string",
						"name": "string"
					},
					"severity_impact_object": {
						"id": "string",
						"name": "string",
						"type": "string",
						"affects_id": "string",
						"position": 0
					},
					"severity_condition_object": {
						"id": "string",
						"name": "string",
						"position": 0
					},
					"private_id": "string",
					"organization_id": "string",
					"milestones": [
						{
							"id": "string",
							"type": "string",
							"duration": "string",
							"occurred_at": "2025-07-16T09:20:11.089Z",
							"created_at": "2025-07-16T09:20:11.089Z",
							"updated_at": "2025-07-16T09:20:11.089Z"
						}
					],
					"lifecycle_phases": [
						{
							"id": "string",
							"name": "string",
							"description": "string",
							"type": "string",
							"position": 0,
							"milestones": [
								{
									"id": "string",
									"name": "string",
									"description": "string",
									"slug": "string",
									"position": 0,
									"occurred_at": "2025-07-16T09:20:11.089Z",
									"duration": "string",
									"updated_by": {
										"id": "string",
										"name": "string",
										"source": "string",
										"email": "string"
									},
									"updated_at": "2025-07-16T09:20:11.089Z"
								}
							]
						}
					],
					"lifecycle_measurements": [
						{
							"id": "string",
							"name": "string",
							"description": "string",
							"slug": "string",
							"starts_at_milestone": "string",
							"ends_at_milestone": "string",
							"value": "string",
							"calculated_at": "2025-07-16T09:20:11.089Z"
						}
					],
					"active": true,
					"labels": {},
					"role_assignments": [
						{
							"id": "string",
							"status": "active",
							"created_at": "2025-07-16T09:20:11.089Z",
							"updated_at": "2025-07-16T09:20:11.089Z",
							"incident_role": {
								"id": "string",
								"name": "string",
								"summary": "string",
								"description": "string",
								"created_at": "2025-07-16T09:20:11.089Z",
								"updated_at": "2025-07-16T09:20:11.089Z",
								"discarded_at": "2025-07-16T09:20:11.089Z"
							},
							"user": {
								"id": "string",
								"name": "string",
								"email": "string",
								"slack_user_id": "string",
								"slack_linked?": true,
								"created_at": "2025-07-16T09:20:11.089Z",
								"updated_at": "2025-07-16T09:20:11.089Z",
								"signals_enabled_notification_types": [
									"string"
								]
							}
						}
					],
					"status_pages": [
						{
							"id": "string",
							"url": "string",
							"external_id": "string",
							"name": "string",
							"display_name": "string",
							"integration": {
								"id": "string",
								"integration_name": "string",
								"integration_slug": "string",
								"display_name": "string",
								"created_at": "2025-07-16T09:20:11.089Z"
							}
						}
					],
					"incident_url": "string",
					"private_status_page_url": "string",
					"organization": {
						"name": "string",
						"id": "string"
					},
					"customers_impacted": 0,
					"monetary_impact": 0,
					"monetary_impact_cents": 0,
					"last_update": "string",
					"last_note": {
						"id": "string",
						"body": "string",
						"created_at": "2025-07-16T09:20:11.089Z",
						"status_pages": [
							{
								"id": "string",
								"url": "string",
								"external_id": "string",
								"name": "string",
								"display_name": "string",
								"integration": {
									"id": "string",
									"integration_name": "string",
									"integration_slug": "string",
									"display_name": "string",
									"created_at": "2025-07-16T09:20:11.089Z"
								}
							}
						],
						"conversations": [
							{
								"id": "string",
								"resource_class": "string",
								"resource_id": "string",
								"field": "string",
								"comments_url": "string",
								"channel": {
									"name": "string"
								}
							}
						]
					},
					"report_id": "string",
					"ai_incident_summary": "string",
					"services": [
						{
							"id": "string",
							"name": "string"
						}
					],
					"environments": [
						{
							"id": "string",
							"name": "string"
						}
					],
					"functionalities": [
						{
							"id": "string",
							"name": "string"
						}
					],
					"channel_name": "string",
					"channel_reference": "string",
					"channel_id": "string",
					"channel_status": "string",
					"incident_tickets": [
						{
							"id": "string",
							"summary": "string",
							"description": "string",
							"state": "open",
							"type": "incident",
							"assignees": [
								{
									"id": "string",
									"name": "string",
									"source": "string",
									"email": "string"
								}
							],
							"priority": {
								"id": "string",
								"name": "string",
								"position": 0,
								"created_at": "2025-07-16T09:20:11.089Z",
								"updated_at": "2025-07-16T09:20:11.089Z"
							},
							"created_by": {
								"id": "string",
								"name": "string",
								"source": "string",
								"email": "string"
							},
							"attachments": [
								{}
							],
							"created_at": "2025-07-16T09:20:11.089Z",
							"updated_at": "2025-07-16T09:20:11.089Z",
							"tag_list": [
								"string"
							],
							"incident_id": "string",
							"incident_name": "string",
							"incident_current_milestone": "string",
							"task_id": "string",
							"due_at": "2025-07-16T09:20:11.089Z",
							"sync_error_message": "string",
							"link": {
								"id": "string",
								"type": "string",
								"display_text": "string",
								"href_url": "string",
								"icon_url": "string",
								"editable": true,
								"deletable": true
							}
						}
					],
					"ticket": {
						"id": "string",
						"summary": "string",
						"description": "string",
						"state": "open",
						"type": "incident",
						"assignees": [
							{
								"id": "string",
								"name": "string",
								"source": "string",
								"email": "string"
							}
						],
						"priority": {
							"id": "string",
							"name": "string",
							"position": 0,
							"created_at": "2025-07-16T09:20:11.089Z",
							"updated_at": "2025-07-16T09:20:11.089Z"
						},
						"created_by": {
							"id": "string",
							"name": "string",
							"source": "string",
							"email": "string"
						},
						"attachments": [
							{}
						],
						"created_at": "2025-07-16T09:20:11.089Z",
						"updated_at": "2025-07-16T09:20:11.089Z",
						"tag_list": [
							"string"
						],
						"incident_id": "string",
						"incident_name": "string",
						"incident_current_milestone": "string",
						"task_id": "string",
						"due_at": "2025-07-16T09:20:11.089Z",
						"sync_error_message": "string",
						"link": {
							"id": "string",
							"type": "string",
							"display_text": "string",
							"href_url": "string",
							"icon_url": "string",
							"editable": true,
							"deletable": true
						}
					},
					"impacts": [
						{
							"id": "string",
							"type": "customer",
							"impact": {
								"id": "string",
								"name": "string"
							},
							"condition": {
								"id": "string",
								"name": "string",
								"position": 0
							},
							"conversations": [
								{
									"id": "string",
									"resource_class": "string",
									"resource_id": "string",
									"field": "string",
									"comments_url": "string",
									"channel": {
										"name": "string"
									}
								}
							]
						}
					],
					"conference_bridges": [
						{
							"id": "string",
							"attachments": [
								{}
							],
							"has_translated_transcripts": true,
							"language_codes": [
								"string"
							],
							"transcription_status": "string",
							"transcription_sub_code": "string"
						}
					],
					"incident_channels": [
						{
							"id": "string",
							"name": "string",
							"source": "string",
							"source_name": "string",
							"source_id": "string",
							"url": "string",
							"icon_url": "string",
							"status": "string"
						}
					],
					"retro_exports": [
						{}
					],
					"created_by": {
						"id": "string",
						"name": "string",
						"source": "string",
						"email": "string"
					},
					"context_object": {
						"object_type": "string",
						"object_id": "string",
						"context_tag": "string",
						"context_description": "string"
					},
					"team_assignments": [
						{
							"id": "string",
							"status": "string",
							"created_at": "2025-07-16T09:20:11.089Z",
							"updated_at": "2025-07-16T09:20:11.089Z",
							"team": {
								"id": "string",
								"name": "string",
								"description": "string",
								"slug": "string",
								"created_at": "2025-07-16T09:20:11.089Z",
								"updated_at": "2025-07-16T09:20:11.089Z",
								"signals_ical_url": "string",
								"created_by": {
									"id": "string",
									"name": "string",
									"source": "string",
									"email": "string"
								},
								"in_support_hours": true
							}
						}
					],
					"conversations": [
						{
							"id": "string",
							"resource_class": "string",
							"resource_id": "string",
							"field": "string",
							"comments_url": "string",
							"channel": {
								"name": "string"
							}
						}
					],
					"custom_fields": [
						{
							"name": "string",
							"value_type": "string",
							"display_name": "string",
							"description": "string",
							"slug": "string",
							"field_id": "string",
							"value_array": [
								"string"
							],
							"value_string": "string",
							"value": "string"
						}
					],
					"field_requirements": [
						{
							"field_id": "string",
							"required_at_milestone_id": "string"
						}
					]
				}
			},
			"memberships": [
				{
					"user": {
						"id": "string",
						"name": "string",
						"email": "string",
						"slack_user_id": "string",
						"slack_linked?": true,
						"created_at": "2025-07-16T09:20:11.089Z",
						"updated_at": "2025-07-16T09:20:11.089Z",
						"signals_enabled_notification_types": [
							"string"
						]
					},
					"schedule": {
						"id": "string",
						"name": "string",
						"integration": "string",
						"discarded": true
					},
					"signals_on_call_schedule": {
						"id": "string",
						"name": "string"
					},
					"default_incident_role": {
						"id": "string",
						"name": "string",
						"summary": "string",
						"description": "string",
						"created_at": "2025-07-16T09:20:11.089Z",
						"updated_at": "2025-07-16T09:20:11.089Z",
						"discarded_at": "2025-07-16T09:20:11.089Z"
					}
				}
			],
			"owned_checklist_templates": [
				{
					"id": "string",
					"name": "string",
					"description": "string",
					"created_at": "string",
					"updated_at": "2025-07-16T09:20:11.089Z",
					"checks": [
						{
							"id": "string",
							"name": "string",
							"description": "string",
							"status": true
						}
					],
					"owner": {
						"id": "string",
						"name": "string",
						"description": "string",
						"slug": "string",
						"created_at": "2025-07-16T09:20:11.089Z",
						"updated_at": "2025-07-16T09:20:11.089Z",
						"signals_ical_url": "string",
						"created_by": {
							"id": "string",
							"name": "string",
							"source": "string",
							"email": "string"
						},
						"in_support_hours": true
					},
					"connected_services": [
						{
							"id": "string",
							"name": "string",
							"description": "string",
							"slug": "string",
							"service_tier": 0,
							"created_at": "2025-07-16T09:20:11.089Z",
							"updated_at": "2025-07-16T09:20:11.089Z",
							"allowed_params": [
								"string"
							],
							"labels": {},
							"alert_on_add": true,
							"auto_add_responding_team": true,
							"completed_checks": 0,
							"owner": {
								"id": "string",
								"name": "string",
								"description": "string",
								"slug": "string",
								"created_at": "2025-07-16T09:20:11.089Z",
								"updated_at": "2025-07-16T09:20:11.089Z",
								"signals_ical_url": "string",
								"created_by": {
									"id": "string",
									"name": "string",
									"source": "string",
									"email": "string"
								},
								"in_support_hours": true
							},
							"service_checklist_updated_at": "2025-07-16T09:20:11.089Z"
						}
					]
				}
			],
			"owned_functionalities": [
				{
					"id": "string",
					"name": "string",
					"slug": "string",
					"description": "string",
					"created_at": "2025-07-16T09:20:11.089Z",
					"updated_at": "2025-07-16T09:20:11.089Z",
					"labels": {},
					"active_incidents": [
						"string"
					],
					"links": [
						{
							"id": "string",
							"href_url": "string",
							"icon_url": "string",
							"name": "string"
						}
					],
					"owner": {
						"id": "string",
						"name": "string",
						"description": "string",
						"slug": "string",
						"created_at": "2025-07-16T09:20:11.089Z",
						"updated_at": "2025-07-16T09:20:11.089Z",
						"signals_ical_url": "string",
						"created_by": {
							"id": "string",
							"name": "string",
							"source": "string",
							"email": "string"
						},
						"in_support_hours": true
					},
					"alert_on_add": true,
					"auto_add_responding_team": true,
					"updated_by": {
						"id": "string",
						"name": "string",
						"source": "string",
						"email": "string"
					}
				}
			],
			"owned_services": [
				{
					"id": "string",
					"name": "string",
					"description": "string",
					"slug": "string",
					"service_tier": 0,
					"created_at": "2025-07-16T09:20:11.089Z",
					"updated_at": "2025-07-16T09:20:11.089Z",
					"allowed_params": [
						"string"
					],
					"labels": {},
					"alert_on_add": true,
					"auto_add_responding_team": true
				}
			],
			"owned_runbooks": [
				{
					"id": "string",
					"name": "string",
					"summary": "string",
					"description": "string",
					"type": "string",
					"created_at": "2025-07-16T09:20:11.089Z",
					"updated_at": "2025-07-16T09:20:11.089Z",
					"attachment_rule": {
						"logic": {},
						"user_data": {
							"type": "string",
							"value": "string",
							"label": "string"
						}
					},
					"owner": {
						"id": "string",
						"name": "string",
						"description": "string",
						"slug": "string",
						"created_at": "2025-07-16T09:20:11.089Z",
						"updated_at": "2025-07-16T09:20:11.089Z",
						"signals_ical_url": "string",
						"created_by": {
							"id": "string",
							"name": "string",
							"source": "string",
							"email": "string"
						},
						"in_support_hours": true
					},
					"categories": [
						"string"
					]
				}
			],
			"responding_services": [
				{
					"id": "string",
					"name": "string",
					"description": "string",
					"slug": "string",
					"service_tier": 0,
					"created_at": "2025-07-16T09:20:11.089Z",
					"updated_at": "2025-07-16T09:20:11.089Z",
					"allowed_params": [
						"string"
					],
					"labels": {},
					"alert_on_add": true,
					"auto_add_responding_team": true
				}
			],
			"services": [
				{
					"id": "string",
					"name": "string",
					"description": "string",
					"slug": "string",
					"service_tier": 0,
					"created_at": "2025-07-16T09:20:11.089Z",
					"updated_at": "2025-07-16T09:20:11.089Z",
					"allowed_params": [
						"string"
					],
					"labels": {},
					"alert_on_add": true,
					"auto_add_responding_team": true
				}
			],
			"functionalities": [
				{
					"id": "string",
					"name": "string",
					"slug": "string",
					"description": "string",
					"created_at": "2025-07-16T09:20:11.089Z",
					"updated_at": "2025-07-16T09:20:11.089Z",
					"labels": {},
					"active_incidents": [
						"string"
					],
					"links": [
						{
							"id": "string",
							"href_url": "string",
							"icon_url": "string",
							"name": "string"
						}
					],
					"owner": {
						"id": "string",
						"name": "string",
						"description": "string",
						"slug": "string",
						"created_at": "2025-07-16T09:20:11.089Z",
						"updated_at": "2025-07-16T09:20:11.089Z",
						"signals_ical_url": "string",
						"created_by": {
							"id": "string",
							"name": "string",
							"source": "string",
							"email": "string"
						},
						"in_support_hours": true
					},
					"alert_on_add": true,
					"auto_add_responding_team": true,
					"updated_by": {
						"id": "string",
						"name": "string",
						"source": "string",
						"email": "string"
					}
				}
			],
			"default_signals_escalation_policy": {
				"id": "string",
				"name": "string"
			}
		}
	],
	"pagination": {
		"count": 0,
		"page": 0,
		"items": 0,
		"pages": 0,
		"last": 0,
		"prev": 0,
		"next": 0
	}
}

​
Workflow Library Example

List Teams with Firehydrant and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop