# GASP — provide a foreign GASP node

> For the complete documentation index, see [llms.txt](https://bsvblockchain.com/docs/llms.txt).

**POST** `/requestForeignGASPNode`

Base URL: `https://{fqdn}`

Used by a peer overlay node to request a specific GASP node (graph vertex)
by its graphID, txid, and outputIndex. The engine's `provideForeignGASPNode`
method handles the request.

## Body

Content type: `application/json`

- `graphID` (string, required)
- `txid` (string, required)
- `outputIndex` (integer, required)

Example:

```json
{
  "graphID": "string",
  "txid": "string",
  "outputIndex": 0
}
```

## Responses

### 200

GASP node data.

Example:

```json
{}
```

### 400

Bad request — validation error or missing required field.

- `status` (string, required)
- `message` (string, required)
- `code` (string)
  Stable machine-readable error code (see specs/errors.md).

Example:

```json
{
  "status": "string",
  "message": "string",
  "code": "string"
}
```

### 500

Unexpected internal error.

- `status` (string, required)
- `message` (string, required)
- `code` (string)
  Stable machine-readable error code (see specs/errors.md).

Example:

```json
{
  "status": "string",
  "message": "string",
  "code": "string"
}
```