List issues

get

https://api.hud.io/v1/issues

Retrieve a paginated list of issues detected by Hud.

Filtering Options:

Filter by environment (default: production)
Filter by service ID(s) or service name(s)
Filter by time range (relative like "7d" or explicit ISO 8601 timestamps)
Filter by custom tags

Response: Returns an array of issues with pagination metadata. Each issue includes:

Issue details (id, type, title, summary)
Timing information (first_seen_at, last_seen_at)
Affected entity details (endpoint, queue, or function)
Source function

Example: GET /issues?relative_time_frame=7d&service_name=payment-service&limit=10

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

environment

string

Defaults to production

Filter issues by deployment environment (e.g., production, staging). Defaults to "production"

service_id

number | array

Filter by service ID(s). Accepts single value or array. Cannot be used together with service_name

service_name

string | array

Filter by service name(s). Accepts single value or array. Cannot be used together with service_id

relative_time_frame

string

enum

Defaults to 7d

Relative time window for filtering issues. Options: 1h (last hour), 1d (last day), 7d (last week), 14d (last 2 weeks), 30d (last month), 60d (last 2 months). Defaults to "7d". Cannot be used with explicit_time_frame_start/end

Allowed:

explicit_time_frame_start

date-time

Start of explicit time range in ISO 8601 format (e.g., "2024-01-15T00:00:00Z"). Must be used together with explicit_time_frame_end. Cannot be used with relative_time_frame

explicit_time_frame_end

date-time

End of explicit time range in ISO 8601 format (e.g., "2024-01-22T23:59:59Z"). Must be used together with explicit_time_frame_start. Cannot be used with relative_time_frame

limit

number

1 to 100

Defaults to 50

Maximum number of issues to return per page. Range: 1-100. Defaults to 50

offset

number

≥ 0

Defaults to 0

Number of issues to skip for pagination. Defaults to 0

sort_by

string

enum

Defaults to last_seen_at

Field to sort results by. Options: detected_at, first_seen_at, last_seen_at. Defaults to "last_seen_at"

Allowed:

sort_order

string

enum

Defaults to desc

Sort direction. Options: asc (oldest first), desc (newest first). Defaults to "desc"

Allowed:

200Paginated list of production issues

401Unauthorized

500InternalServerError