# Get the status of a transaction by path parameter

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

**GET** `/v1/tx/{txid}`

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

Retrieves the current network status of a transaction using the txid as a
path parameter. Semantically equivalent to GET /v1/tx?txid={txid}.

## Header parameters

- `Authorization` (string)
  Bearer token: `Bearer <apiKey>`
- `XDeployment-ID` (string)
  Deployment identifier for correlating requests. Auto-generated if not set.

## Path parameters

- `txid` (string, required)
  Transaction ID (64 hex characters).

## Responses

### 200

Transaction status.

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

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

### 404

Transaction not found.

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