# Globalping

Globalping is a global network of probes that allows users to run network tests like ping, traceroute, and DNS resolve from various locations worldwide.

- **Category:** server monitoring
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `GLOBALPING`
- **Version:** 20260223_00

## Tools

### Create Measurement

**Slug:** `GLOBALPING_CREATE_MEASUREMENT`

Tool to create and trigger a network measurement. Use when you need connectivity checks from specific geographic or network locations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("ping" | "traceroute" | "dns" | "mtr" | "http") | Yes | Measurement type to run |
| `limit` | integer | No | Global max probes; mutually exclusive with per-location limit |
| `target` | string | Yes | Publicly reachable target hostname or IP |
| `locations` | array | No | List of location filters specifying where to run probes. Each filter can use continent, country, city, asn, network, or a 'magic' fuzzy string. Combine filters with '+' in magic (e.g., 'US+AWS'). Defaults to 1 random probe worldwide if omitted. |
| `inProgressUpdates` | boolean | No | Stream partial results if true |
| `measurementOptions` | string | No | Options specific to the chosen measurement type |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Rate Limits

**Slug:** `GLOBALPING_GET_LIMITS`

Tool to retrieve current rate limits and credits. Use this to check remaining API quota before making measurements. Returns rate limits based on IP address for unauthenticated requests or user account for authenticated requests.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Measurement Results

**Slug:** `GLOBALPING_GET_MEASUREMENT`

Retrieve measurement results by ID. Use this after creating a measurement to get the status and detailed results from all participating probes. Poll this endpoint until status is 'finished'.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Measurement identifier returned from a create measurement request |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### GlobalPing Health Check

**Slug:** `GLOBALPING_HEALTH_CHECK`

Tool to check API health status. Use when verifying API availability.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Probes

**Slug:** `GLOBALPING_LIST_PROBES`

Retrieve all currently online Globalping probes worldwide. Returns probe metadata including location (continent, country, city), network information (ASN, ISP name), and tags (datacenter-network, eyeball-network, cloud provider tags). Use max_results parameter to limit response size since the API typically returns ~3500 active probes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `max_results` | integer | No | Maximum number of probes to return. The API returns ~3500 active probes by default, so set this to limit the response size (e.g., 10 or 50) for faster processing. Applied as client-side trimming. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |