# Submit a batch of transactions

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

**POST** `/v1/txs`

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

Submits an array of raw transactions in a single HTTP request.
The SDK's `ARC.broadcastMany()` calls this endpoint. Each item in the
array contains a single `rawTx` field (hex-encoded).

Responses are an array of the same length, where each element corresponds
to the same-index input transaction. Some may succeed while others fail.

## Header parameters

- `Authorization` (string)
  Bearer token: `Bearer <apiKey>`
- `XDeployment-ID` (string)
  Deployment identifier for correlating requests. Auto-generated if not set.
- `X-CallbackUrl` (string)
  HTTPS URL to which ARC will POST a Merkle proof callback once the
  transaction has been mined.
- `X-CallbackToken` (string)
  Bearer token that ARC will include in the `Authorization` header when
  calling the callback URL. Used to verify the callback origin.

## Body

Content type: `application/json`

- `rawTx` (string, required)
  Hex-encoded raw transaction. The ts-sdk attempts Extended Format (EF)
  first; falls back to standard raw hex when source transactions are missing.

Example:

```json
[
  {
    "rawTx": "0100000001..."
  }
]
```

## Responses

### 200

Array of per-transaction results. Each element may be a success
(`ArcTxResponse`) or an error (`ArcErrorResponse`). The array length
matches the input array length.

- `txid` (string, required)
  Transaction ID.
- `txStatus` ("STORED" | "ANNOUNCED_TO_NETWORK" | "REQUESTED_BY_NETWORK" | "SENT_TO_NETWORK" | "ACCEPTED_BY_NETWORK" | "SEEN_ON_NETWORK" | "MINED" | "SEEN_IN_ORPHAN_MEMPOOL" | "DOUBLE_SPEND_ATTEMPTED" | "REJECTED" | "INVALID" | "MALFORMED" | "MINED_IN_STALE_BLOCK" | "UNKNOWN", required)
  Network status of the transaction as reported by ARC.
  Success statuses (HTTP 200, not treated as failure):
    - STORED — received but not yet broadcast
    - ANNOUNCED_TO_NETWORK — gossiped to peers
    - REQUESTED_BY_NETWORK — requested by a peer
    - SENT_TO_NETWORK — submitted to the network
    - ACCEPTED_BY_NETWORK — accepted by at least one miner
    - SEEN_ON_NETWORK — seen propagating on the network
    - MINED — included in a block (Merkle proof available)
    - SEEN_IN_ORPHAN_MEMPOOL — in an orphan block mempool (not a stable success)
  Failure statuses (HTTP 200 body, treated as BroadcastFailure by ts-sdk):
    - DOUBLE_SPEND_ATTEMPTED
    - REJECTED
    - INVALID
    - MALFORMED
    - MINED_IN_STALE_BLOCK
    - (any value containing "ORPHAN" in extraInfo or txStatus)
  Unknown:
    - UNKNOWN
- `extraInfo` (string)
  Additional human-readable context about the status.
- `competingTxs` (string[])
  Present when `txStatus` is `DOUBLE_SPEND_ATTEMPTED`. Lists competing
  transaction IDs.

Example:

```json
[
  {
    "txid": "string",
    "txStatus": "STORED",
    "extraInfo": "string",
    "competingTxs": [
      "string"
    ]
  }
]
```

### 400

Batch-level bad request.

- `txid` (string)
  Transaction ID if known at the time of error.
- `detail` (string)
  Human-readable error detail. Mapped to `description` in BroadcastFailure.
- `status` (integer)
  HTTP status code echoed in the body (ARC convention).
- `title` (string)
  Short error title.
- `type` (string<uri>)
  URI identifying the error type.
- `instance` (string)
  URI identifying the specific occurrence.
- `extraInfo` (string)

Example:

```json
{
  "txid": "string",
  "detail": "string",
  "status": 0,
  "title": "string",
  "type": "string",
  "instance": "string",
  "extraInfo": "string"
}
```

### 401

Unauthorized.

- `txid` (string)
  Transaction ID if known at the time of error.
- `detail` (string)
  Human-readable error detail. Mapped to `description` in BroadcastFailure.
- `status` (integer)
  HTTP status code echoed in the body (ARC convention).
- `title` (string)
  Short error title.
- `type` (string<uri>)
  URI identifying the error type.
- `instance` (string)
  URI identifying the specific occurrence.
- `extraInfo` (string)

Example:

```json
{
  "txid": "string",
  "detail": "string",
  "status": 0,
  "title": "string",
  "type": "string",
  "instance": "string",
  "extraInfo": "string"
}
```

### 500

Internal server error.

- `txid` (string)
  Transaction ID if known at the time of error.
- `detail` (string)
  Human-readable error detail. Mapped to `description` in BroadcastFailure.
- `status` (integer)
  HTTP status code echoed in the body (ARC convention).
- `title` (string)
  Short error title.
- `type` (string<uri>)
  URI identifying the error type.
- `instance` (string)
  URI identifying the specific occurrence.
- `extraInfo` (string)

Example:

```json
{
  "txid": "string",
  "detail": "string",
  "status": 0,
  "title": "string",
  "type": "string",
  "instance": "string",
  "extraInfo": "string"
}
```