Skip to main content
GET
/
projects
/
{projectId}
/
environments
/
{environmentId}
/
observability
/
http
/
breakdown
/
ips
Error
A valid request URL is required to generate request examples
{
  "_grain": 5,
  "_from": 1704067200,
  "_to": 1704153600,
  "_project_id": "abc123def456",
  "_environment_id": "main",
  "_environment_type": "production",
  "_branch_machine_name": "main-bvxea6i",
  "_breakdown_limit": 200,
  "_breakdown_top_hits": 10,
  "breakdown": {
    "kind": "ip",
    "total": 396519,
    "data": [
      {
        "name": "192.168.1.1",
        "impact": 15.67,
        "average": 0.234,
        "p_50": 0.156,
        "p_96": 0.892,
        "count": 62143,
        "top_hit": true
      },
      {
        "name": "10.0.0.5",
        "impact": 12.34,
        "average": 0.189,
        "p_50": 0.123,
        "p_96": 0.756,
        "count": 48921,
        "top_hit": true
      },
      {
        "name": "172.16.0.10",
        "impact": 8.45,
        "average": 0.312,
        "p_50": 0.201,
        "p_96": 1.234,
        "count": 33512,
        "top_hit": false
      }
    ]
  },
  "top_hits_timeline": {
    "data": [
      {
        "timestamp": 1704067200,
        "_total_consumed": 5678.9,
        "_total_count": 4120,
        "data": {
          "192.168.1.1": {
            "count": 1543,
            "impact": 37.45
          }
        }
      },
      {
        "timestamp": 1704070800
      },
      {
        "timestamp": 1704074400,
        "_total_consumed": 4321.2,
        "_total_count": 3891,
        "data": {
          "10.0.0.5": {
            "count": 1247,
            "impact": 30.26
          }
        }
      }
    ]
  },
  "_applications": [
    "app"
  ],
  "_methods": [
    "GET"
  ],
  "_domains": [
    "example.com"
  ],
  "_code_slots": [
    "2XX"
  ],
  "_codes": [
    "200"
  ],
  "_request_duration_slots": [
    "0-100"
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
projectId
string
required

The unique identifier of the Upsun project

Pattern: [a-z0-9]+
Example:

"abc123def456"

​
environmentId
string
required

The environment identifier

Pattern: .+
Example:

"main"

Query Parameters

​
from
integer<int64>
required

Start timestamp for the time range (Unix timestamp in seconds)

Example:

1704067200

​
to
integer<int64>
required

End timestamp for the time range (Unix timestamp in seconds)

Example:

1704153600

​
limit
integer

Maximum number of items to return (default: 200, max: 300)

Required range: 1 <= x <= 300
​
top_hits_count
integer

Number of items to flag as top hits and track in the timeline (default: 10, max: 15). Items with index < top_hits_count have top_hit=true; the remainder up to limit are returned with top_hit=false.

Required range: 1 <= x <= 15
​
applications[]
string[]

Filter by application. Can be specified multiple times for multiple values (e.g., ?applications[]=app1&applications[]=app2). Use applications_mode to control inclusion/exclusion behavior.

​
applications_mode
enum<string>

Filter mode for applications parameter. "1" (additive) includes only specified applications. "-1" (subtractive) excludes specified applications and includes all others. When omitted: defaults to "-1" if no applications values are provided; defaults to "1" (additive) if at least one applications value is provided.

Available options:
1,
-1
Example:

"1"

​
methods[]
enum<string>[]

Filter by HTTP methods. Can be specified multiple times for multiple values (e.g., ?methods[]=GET&methods[]=POST). Use methods_mode to control inclusion/exclusion behavior.

Available options:
GET,
POST,
PUT,
PATCH,
DELETE,
HEAD,
OPTIONS
​
methods_mode
enum<string>

Filter mode for methods parameter. "1" (additive) includes only specified methods. "-1" (subtractive) excludes specified methods and includes all others. When omitted: defaults to "-1" if no methods values are provided; defaults to "1" (additive) if at least one methods value is provided.

Available options:
1,
-1
Example:

"1"

​
domains[]
string[]

Filter by request domains/hosts. Can be specified multiple times for multiple values (e.g., ?domains[]=api.example.com&domains[]=www.example.com). Use domains_mode to control inclusion/exclusion behavior.

​
domains_mode
enum<string>

Filter mode for domains parameter. "1" (additive) includes only specified domains. "-1" (subtractive) excludes specified domains and includes all others. When omitted: defaults to "-1" if no domains values are provided; defaults to "1" (additive) if at least one domains value is provided.

Available options:
1,
-1
Example:

"1"

​
code_slots[]
enum<string>[]

Filter by HTTP status code groups. Can be specified multiple times for multiple values (e.g., ?code_slots[]=4XX&code_slots[]=5XX). Use code_slots_mode to control inclusion/exclusion behavior.

Available options:
1XX,
2XX,
3XX,
4XX,
5XX
​
code_slots_mode
enum<string>

Filter mode for code_slots parameter. "1" (additive) includes only specified code groups. "-1" (subtractive) excludes specified code groups and includes all others. When omitted: defaults to "-1" if no code_slots values are provided; defaults to "1" (additive) if at least one code_slots value is provided.

Available options:
1,
-1
Example:

"1"

​
codes[]
string[]

Filter by specific HTTP status codes. Can be specified multiple times for multiple values (e.g., ?codes[]=200&codes[]=404). Use codes_mode to control inclusion/exclusion behavior.

​
codes_mode
enum<string>

Filter mode for codes parameter. "1" (additive) includes only specified codes. "-1" (subtractive) excludes specified codes and includes all others. When omitted: defaults to "-1" if no codes values are provided; defaults to "1" (additive) if at least one codes value is provided.

Available options:
1,
-1
Example:

"1"

​
request_duration_slots[]
enum<string>[]

Filter by response time ranges (in milliseconds). Can be specified multiple times for multiple values (e.g., ?request_duration_slots[]=0-50&request_duration_slots[]=1600+). Use request_duration_slots_mode to control inclusion/exclusion behavior.

Available options:
0-50,
50-100,
100-200,
200-400,
400-800,
800-1600,
1600+
​
request_duration_slots_mode
enum<string>

Filter mode for request_duration_slots parameter. "1" (additive) includes only specified duration ranges. "-1" (subtractive) excludes specified duration ranges and includes all others. When omitted: defaults to "-1" if no request_duration_slots values are provided; defaults to "1" (additive) if at least one request_duration_slots value is provided.

Available options:
1,
-1
Example:

"1"

Response

HTTP traffic timeline by IP retrieved successfully

​
_grain
integer
required

Data granularity in seconds

Example:

5

​
_from
integer
required

Query start timestamp

Example:

1704067200

​
_to
integer
required

Query end timestamp

Example:

1704153600

​
_project_id
string
required

Project identifier

Example:

"abc123def456"

​
_environment_id
string
required

Environment identifier

Example:

"main"

​
_environment_type
enum<string>
required

Environment type

Available options:
production,
staging,
development
Example:

"production"

​
_branch_machine_name
string
required

Branch machine name

Example:

"main-bvxea6i"

​
_breakdown_limit
integer
required

Maximum number of items returned

Example:

200

​
_breakdown_top_hits
integer
required

Number of items flagged as top hits (top_hit=true) and tracked in top_hits_timeline.

Example:

10

​
breakdown
object
required

IP addresses ranked by impact

​
top_hits_timeline
object
required

Time-series data for top hit items

​
_applications
string[] | null

Applied application filter values

​
_applications_mode
enum<string> | null

Application filter mode (1=additive, -1=subtractive)

Available options:
1,
-1
​
_methods
string[] | null

Applied method filter values

​
_methods_mode
enum<string> | null

Method filter mode (1=additive, -1=subtractive)

Available options:
1,
-1
​
_domains
string[] | null

Applied domain filter values

​
_domains_mode
enum<string> | null

Domain filter mode (1=additive, -1=subtractive)

Available options:
1,
-1
​
_code_slots
string[] | null

Applied code slot filter values

​
_code_slots_mode
enum<string> | null

Code slot filter mode (1=additive, -1=subtractive)

Available options:
1,
-1
​
_codes
string[] | null

Applied HTTP status code filter values

​
_codes_mode
enum<string> | null

Code filter mode (1=additive, -1=subtractive)

Available options:
1,
-1
​
_request_duration_slots
string[] | null

Applied request duration slot filter values

​
_request_duration_slots_mode
enum<string> | null

Request duration slot filter mode (1=additive, -1=subtractive)

Available options:
1,
-1
Last modified on June 16, 2026