# Submit a single transaction

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

**POST** `/v1/tx`

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

Submits a single raw transaction to the ARC network. The body must be a
JSON object with a `rawTx` field containing the hex-encoded transaction.

The SDK tries Extended Format (EF) first (`tx.toHexEF()`). If EF is not
available (source transactions missing), it falls back to raw hex (`tx.toHex()`).

ARC may return HTTP 200 with `txStatus` values that indicate failure
(e.g. `DOUBLE_SPEND_ATTEMPTED`, `REJECTED`, `INVALID`, `MALFORMED`,
`MINED_IN_STALE_BLOCK`, or any status containing `ORPHAN`). These are
treated as broadcast failures by the SDK.

## 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

Transaction accepted (or accepted with a warning status). Note: ARC
may return HTTP 200 with a `txStatus` that indicates rejection. Callers
must inspect `txStatus` to determine success vs. failure.

- `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

Bad request — malformed payload.

- `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

Missing or invalid Authorization header.

- `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"
}
```

### 409

Conflict — e.g. transaction already known.

- `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"
}
```

### 422

Unprocessable entity — invalid transaction.

- `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"
}
```

### 429

Rate limit exceeded.

- `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

ARC internal 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"
}
```