> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bringits.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HTTP Request - Got

> Execute a single HTTP request using the Got library

The HTTP Request - Got command (Command Type: 1003) executes a single HTTP request using the [Got](https://github.com/sindresorhus/got) Node.js library. Supports HTTP/2, proxy, and TLS settings.

## Command Type

**Command Type ID:** 1003

## Parameters

| Parameter                  | Type            | Description                                                    | Required |
| -------------------------- | --------------- | -------------------------------------------------------------- | -------- |
| **url**                    | string          | The target URL                                                 | Yes      |
| **verb**                   | string          | HTTP method: `"GET"`, `"POST"`, `"PUT"`, `"DELETE"`, `"PATCH"` | Yes      |
| **contentType**            | string          | Payload type: `"JSON"` or `"form-data"`                        | Yes      |
| **timeout**                | number          | Timeout in milliseconds                                        | Yes      |
| **body**                   | object          | Request body for POST/PUT                                      | No       |
| **bypassStatusCode**       | Array of number | Status codes to bypass default error handling                  | No       |
| **headers**                | object          | HTTP headers                                                   | No       |
| **isHttp2**                | boolean         | Enable HTTP/2 for the request                                  | No       |
| **proxy**                  | ProxySettings   | Proxy settings                                                 | No       |
| **proxyConnectionTimeout** | number          | Timeout for proxy connection in milliseconds                   | No       |

### ProxySettings

| Field          | Type       | Description                      | Required |
| -------------- | ---------- | -------------------------------- | -------- |
| **host**       | string     | Proxy server hostname            | Yes      |
| **port**       | string     | Proxy server port                | Yes      |
| **protocol**   | string     | Proxy protocol (e.g., `http`)    | Yes      |
| **auth**       | object     | Proxy authentication credentials | No       |
| **link**       | Link       | Link proxy configuration         | No       |
| **linkTunnel** | LinkTunnel | Link tunnel configuration        | No       |

## Usage Examples

### Basic GET Request

```json theme={null}
{
  "command": "http-request-got",
  "params": {
    "url": "https://api.example.com/data",
    "verb": "GET",
    "contentType": "JSON",
    "timeout": 10000
  }
}
```

### POST with JSON Body

```json theme={null}
{
  "command": "http-request-got",
  "params": {
    "url": "https://api.example.com/submit",
    "verb": "POST",
    "contentType": "JSON",
    "timeout": 15000,
    "body": { "query": "live_data" },
    "headers": { "Authorization": "Bearer %{API_TOKEN}" }
  }
}
```

## Related Commands

* [HTTP Request](/stream/commands/http/http-request) - cloudscraper-based single request
* [HTTP Parallel Request - Got](/stream/commands/http/http-parallel-request-got) - Got-based parallel requests