# ARC Merkle proof callback

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

**POST** `/arc-ingest`

Base URL: `https://arc.taal.com`

ARC POSTs this to the URL specified in `X-CallbackUrl` when a submitted
transaction has been mined and a Merkle path is available.

In the ts-stack overlay, the endpoint is `/arc-ingest` on the overlay
node itself (see OverlayExpress.ts). The overlay node must register this
URL with ARC at submission time via the `X-CallbackUrl` header.

The overlay node calls `engine.handleNewMerkleProof(txid, merklePath, blockHeight)`
upon receiving this callback.

## Header parameters

- `Authorization` (string)
  Bearer token matching the `X-CallbackToken` value set at submission time.
  The overlay node verifies this token before processing.

## Body

Content type: `application/json`

- `txid` (string, required)
  Transaction ID of the mined transaction.
- `merklePath` (string, required)
  Hex-encoded Merkle path (BUMP format).
- `blockHeight` (integer, required)
  Block height at which the transaction was mined.
- `blockHash` (string)
  Hash of the block containing this transaction (optional, not always present).
- `timestamp` (string<date-time>)
  Timestamp of the callback.

Example:

```json
{
  "txid": "string",
  "merklePath": "string",
  "blockHeight": 0,
  "blockHash": "string",
  "timestamp": "1970-01-01T00:00:00.000Z"
}
```

## Responses

### 200

Callback accepted and processed.

- `status` (string, required)
- `message` (string, required)

Example:

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

### 400

Bad request.

- `status` (string, required)
- `message` (string, required)

Example:

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