> For the complete documentation index, see [llms.txt](https://docs.v2.pod.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.v2.pod.network/guides-references/references/rest/bridge.md).

# Bridge

Bridge configuration and withdrawal outcomes, with the claim proof for a single withdrawal. Served by every node.

&#x20;   &#x20;

## Get Bridge Configuration

> The chain withdrawals are claimable on, its bridge contract, the bridge version,\
> and every bridged token.\
> \
> \`claim\_chain\_id\` and \`source\_contract\` are zero and \`tokens\` is empty when the node\
> has no bridge configured. No withdrawal is admissible then.\
> \
> No \`Cache-Control\` header is set.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Bridge","description":"Bridge configuration and withdrawal outcomes, with the claim proof for a single\nwithdrawal. Served by every node.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/bridge/config":{"get":{"tags":["Bridge"],"summary":"Get Bridge Configuration","operationId":"getBridgeConfig","description":"The chain withdrawals are claimable on, its bridge contract, the bridge version,\nand every bridged token.\n\n`claim_chain_id` and `source_contract` are zero and `tokens` is empty when the node\nhas no bridge configured. No withdrawal is admissible then.\n\nNo `Cache-Control` header is set.\n","responses":{"200":{"description":"Bridge configuration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BridgeConfig"}}}}}}}},"components":{"schemas":{"BridgeConfig":{"type":"object","properties":{"claim_chain_id":{"type":"integer","format":"int64","description":"The one chain withdrawals are claimable on. `0` when no bridge is configured."},"source_contract":{"$ref":"#/components/schemas/Address","description":"Bridge contract on that chain. Zero address when no bridge is configured."},"version":{"type":"integer","format":"int64","description":"Bridge version; feeds the claim-hash domain separator."},"tokens":{"type":"array","description":"Every bridged token, ordered by `pod_token`. The only source of the Pod-token to bridged-chain-token mapping. Empty when no bridge is configured.","items":{"type":"object","properties":{"pod_token":{"$ref":"#/components/schemas/Address"},"l1_token":{"$ref":"#/components/schemas/Address"},"decimals":{"type":"integer","description":"Decimals on the bridged chain. A withdrawal amount must be a multiple of `10^(18 - decimals)` wei."},"min":{"$ref":"#/components/schemas/HexUint256","description":"Minimum withdrawal, bridged-chain decimals."},"max":{"$ref":"#/components/schemas/HexUint256","description":"Maximum withdrawal, bridged-chain decimals."}}}}}},"Address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"20-byte address, `0x` hex"},"HexUint256":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"Unsigned 256-bit integer, `0x` hex"}}}}
```

## List Withdrawals

> Withdrawal outcomes for every account, oldest first by \`(timestamp\_us,\
> tx\_hash)\`. Same entries as the \`pod\_withdrawals\` websocket channel, and \`since\` is\
> the same cursor. To continue, pass the last entry's \`timestamp\_us\` as \`since\` and its\
> \`tx\_hash\` as \`since\_id\`.\
> \
> Legacy \`Bridge.withdraw\` rows are excluded.\
> \
> \`/v2/bridge/withdrawals\` returns the same rows with the node's \`timestamp\`.\
> \
> No \`Cache-Control\` header is set.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Bridge","description":"Bridge configuration and withdrawal outcomes, with the claim proof for a single\nwithdrawal. Served by every node.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/bridge/withdrawals":{"get":{"tags":["Bridge"],"summary":"List Withdrawals","operationId":"listWithdrawals","description":"Withdrawal outcomes for every account, oldest first by `(timestamp_us,\ntx_hash)`. Same entries as the `pod_withdrawals` websocket channel, and `since` is\nthe same cursor. To continue, pass the last entry's `timestamp_us` as `since` and its\n`tx_hash` as `since_id`.\n\nLegacy `Bridge.withdraw` rows are excluded.\n\n`/v2/bridge/withdrawals` returns the same rows with the node's `timestamp`.\n\nNo `Cache-Control` header is set.\n","parameters":[{"$ref":"#/components/parameters/WithdrawalSince"},{"$ref":"#/components/parameters/WithdrawalSinceId"},{"$ref":"#/components/parameters/WithdrawalLimit"}],"responses":{"200":{"description":"Withdrawal outcomes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Withdrawal"}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"500":{"$ref":"#/components/responses/InternalError"}}}}},"components":{"parameters":{"WithdrawalSince":{"name":"since","in":"query","description":"Batch deadline in microseconds; returns outcomes strictly after it, or within it after `since_id`.","schema":{"type":"integer","format":"int64","default":0}},"WithdrawalSinceId":{"name":"since_id","in":"query","description":"Last `tx_hash` already seen within the `since` tick, to resume a page that ended mid-tick. Omit to resume after the whole tick.","schema":{"$ref":"#/components/schemas/Bytes32"}},"WithdrawalLimit":{"name":"limit","in":"query","description":"Page size. Values above 1000 are capped at 1000.","schema":{"type":"integer","minimum":0,"maximum":1000,"default":500}}},"schemas":{"Bytes32":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"32-byte value, `0x` hex. Orderbook ids, order ids and hashes."},"Withdrawal":{"type":"object","description":"One withdrawal outcome, as `pod_withdrawals` delivers it.","required":["tx_hash","withdrawer","to","token","amount","timestamp_us"],"properties":{"tx_hash":{"$ref":"#/components/schemas/Bytes32","description":"The withdraw transaction's hash, the withdrawal's id."},"withdrawer":{"$ref":"#/components/schemas/Address","description":"The debited account; the master for a delegated withdrawal."},"to":{"$ref":"#/components/schemas/Address","description":"Recipient on the bridged chain."},"token":{"$ref":"#/components/schemas/Address","description":"Pod-side token."},"amount":{"$ref":"#/components/schemas/HexUint256","description":"Pod's 18 decimals, as signed. `claim` takes `proof.amount`."},"error":{"type":"string","enum":["insufficient_balance","not_included"],"description":"Why the withdrawal was refused. Omitted otherwise."},"timestamp_us":{"type":"integer","format":"int64","description":"The tick's batch deadline, microseconds. Also the `since` cursor."}}},"Address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"20-byte address, `0x` hex"},"HexUint256":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"Unsigned 256-bit integer, `0x` hex"}},"responses":{"BadRequest":{"description":"Malformed path or query parameter. Plain-text reason.","content":{"text/plain":{"schema":{"type":"string"}}}},"InternalError":{"description":"The ledger read failed. Empty body."}}}}
```

## List Account Withdrawals

> As \`/bridge/withdrawals\`, restricted to withdrawals debited from \`account\` (the\
> \`withdrawer\`, which is the master for a delegated withdrawal).\
> \
> No \`Cache-Control\` header is set.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Bridge","description":"Bridge configuration and withdrawal outcomes, with the claim proof for a single\nwithdrawal. Served by every node.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/bridge/withdrawals/{account}":{"get":{"tags":["Bridge"],"summary":"List Account Withdrawals","operationId":"listAccountWithdrawals","description":"As `/bridge/withdrawals`, restricted to withdrawals debited from `account` (the\n`withdrawer`, which is the master for a delegated withdrawal).\n\nNo `Cache-Control` header is set.\n","parameters":[{"$ref":"#/components/parameters/AccountPath"},{"$ref":"#/components/parameters/WithdrawalSince"},{"$ref":"#/components/parameters/WithdrawalSinceId"},{"$ref":"#/components/parameters/WithdrawalLimit"}],"responses":{"200":{"description":"Withdrawal outcomes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Withdrawal"}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"500":{"$ref":"#/components/responses/InternalError"}}}}},"components":{"parameters":{"AccountPath":{"name":"account","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Address"}},"WithdrawalSince":{"name":"since","in":"query","description":"Batch deadline in microseconds; returns outcomes strictly after it, or within it after `since_id`.","schema":{"type":"integer","format":"int64","default":0}},"WithdrawalSinceId":{"name":"since_id","in":"query","description":"Last `tx_hash` already seen within the `since` tick, to resume a page that ended mid-tick. Omit to resume after the whole tick.","schema":{"$ref":"#/components/schemas/Bytes32"}},"WithdrawalLimit":{"name":"limit","in":"query","description":"Page size. Values above 1000 are capped at 1000.","schema":{"type":"integer","minimum":0,"maximum":1000,"default":500}}},"schemas":{"Address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"20-byte address, `0x` hex"},"Bytes32":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"32-byte value, `0x` hex. Orderbook ids, order ids and hashes."},"Withdrawal":{"type":"object","description":"One withdrawal outcome, as `pod_withdrawals` delivers it.","required":["tx_hash","withdrawer","to","token","amount","timestamp_us"],"properties":{"tx_hash":{"$ref":"#/components/schemas/Bytes32","description":"The withdraw transaction's hash, the withdrawal's id."},"withdrawer":{"$ref":"#/components/schemas/Address","description":"The debited account; the master for a delegated withdrawal."},"to":{"$ref":"#/components/schemas/Address","description":"Recipient on the bridged chain."},"token":{"$ref":"#/components/schemas/Address","description":"Pod-side token."},"amount":{"$ref":"#/components/schemas/HexUint256","description":"Pod's 18 decimals, as signed. `claim` takes `proof.amount`."},"error":{"type":"string","enum":["insufficient_balance","not_included"],"description":"Why the withdrawal was refused. Omitted otherwise."},"timestamp_us":{"type":"integer","format":"int64","description":"The tick's batch deadline, microseconds. Also the `since` cursor."}}},"HexUint256":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"Unsigned 256-bit integer, `0x` hex"}},"responses":{"BadRequest":{"description":"Malformed path or query parameter. Plain-text reason.","content":{"text/plain":{"schema":{"type":"string"}}}},"InternalError":{"description":"The ledger read failed. Empty body."}}}}
```

## List Withdrawals (v2)

> As \`/v1/bridge/withdrawals\`, wrapped in an object that adds \`timestamp\`, and\
> accepting \`timestamp\` as a minimum state to wait for.\
> \
> Withdrawal outcomes for every account, oldest first by \`(timestamp\_us,\
> tx\_hash)\`. Same entries as the \`pod\_withdrawals\` websocket channel, and \`since\` is\
> the same cursor. To continue, pass the last entry's \`timestamp\_us\` as \`since\` and its\
> \`tx\_hash\` as \`since\_id\`.\
> \
> Legacy \`Bridge.withdraw\` rows are excluded.\
> \
> No \`Cache-Control\` header is set.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Bridge","description":"Bridge configuration and withdrawal outcomes, with the claim proof for a single\nwithdrawal. Served by every node.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/v2/bridge/withdrawals":{"get":{"tags":["Bridge"],"summary":"List Withdrawals (v2)","operationId":"listWithdrawalsV2","description":"As `/v1/bridge/withdrawals`, wrapped in an object that adds `timestamp`, and\naccepting `timestamp` as a minimum state to wait for.\n\nWithdrawal outcomes for every account, oldest first by `(timestamp_us,\ntx_hash)`. Same entries as the `pod_withdrawals` websocket channel, and `since` is\nthe same cursor. To continue, pass the last entry's `timestamp_us` as `since` and its\n`tx_hash` as `since_id`.\n\nLegacy `Bridge.withdraw` rows are excluded.\n\nNo `Cache-Control` header is set.\n","parameters":[{"$ref":"#/components/parameters/WithdrawalSince"},{"$ref":"#/components/parameters/MinTimestamp"},{"$ref":"#/components/parameters/WithdrawalSinceId"},{"$ref":"#/components/parameters/WithdrawalLimit"}],"responses":{"200":{"description":"Withdrawal outcomes","content":{"application/json":{"schema":{"type":"object","required":["withdrawals","timestamp"],"properties":{"withdrawals":{"type":"array","items":{"$ref":"#/components/schemas/Withdrawal"}},"timestamp":{"$ref":"#/components/schemas/Timestamp","description":"Deadline of the newest tick whose outcomes the answering node serves. Never ahead of the rows. Pass it as `since` to `pod_withdrawals` to resume with no gap."}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/NodeBehind"}}}}},"components":{"parameters":{"WithdrawalSince":{"name":"since","in":"query","description":"Batch deadline in microseconds; returns outcomes strictly after it, or within it after `since_id`.","schema":{"type":"integer","format":"int64","default":0}},"MinTimestamp":{"name":"timestamp","in":"query","description":"The lowest tick deadline accepted, in microseconds — typically the highest `timestamp`\n(or `solution_now`) already held. The node answers once the state behind the route has\nreached it, otherwise `503` after its wait (default 2s, `POD_RPC_TIMESTAMP_WAIT`).\nOmitted means answer now.\n","schema":{"type":"integer","format":"int64"}},"WithdrawalSinceId":{"name":"since_id","in":"query","description":"Last `tx_hash` already seen within the `since` tick, to resume a page that ended mid-tick. Omit to resume after the whole tick.","schema":{"$ref":"#/components/schemas/Bytes32"}},"WithdrawalLimit":{"name":"limit","in":"query","description":"Page size. Values above 1000 are capped at 1000.","schema":{"type":"integer","minimum":0,"maximum":1000,"default":500}}},"schemas":{"Bytes32":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"32-byte value, `0x` hex. Orderbook ids, order ids and hashes."},"Withdrawal":{"type":"object","description":"One withdrawal outcome, as `pod_withdrawals` delivers it.","required":["tx_hash","withdrawer","to","token","amount","timestamp_us"],"properties":{"tx_hash":{"$ref":"#/components/schemas/Bytes32","description":"The withdraw transaction's hash, the withdrawal's id."},"withdrawer":{"$ref":"#/components/schemas/Address","description":"The debited account; the master for a delegated withdrawal."},"to":{"$ref":"#/components/schemas/Address","description":"Recipient on the bridged chain."},"token":{"$ref":"#/components/schemas/Address","description":"Pod-side token."},"amount":{"$ref":"#/components/schemas/HexUint256","description":"Pod's 18 decimals, as signed. `claim` takes `proof.amount`."},"error":{"type":"string","enum":["insufficient_balance","not_included"],"description":"Why the withdrawal was refused. Omitted otherwise."},"timestamp_us":{"type":"integer","format":"int64","description":"The tick's batch deadline, microseconds. Also the `since` cursor."}}},"Address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"20-byte address, `0x` hex"},"HexUint256":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"Unsigned 256-bit integer, `0x` hex"},"Timestamp":{"type":"integer","format":"int64","description":"Unix time in microseconds, as a JSON number"},"NodeBehindBody":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"$ref":"#/components/schemas/Timestamp","description":"The node's current value for the route."}}}},"responses":{"BadRequest":{"description":"Malformed path or query parameter. Plain-text reason.","content":{"text/plain":{"schema":{"type":"string"}}}},"InternalError":{"description":"The ledger read failed. Empty body."},"NodeBehind":{"description":"The node did not reach the requested `timestamp` within its wait; a value later than the node's clock plus the wait is rejected without waiting. Sent with `Retry-After: 1` and `Cache-Control: no-store`.","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeBehindBody"}}}}}}}
```

## List Account Withdrawals (v2)

> As \`/v2/bridge/withdrawals\`, restricted to withdrawals debited from \`account\` (the\
> \`withdrawer\`, which is the master for a delegated withdrawal).\
> \
> No \`Cache-Control\` header is set.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Bridge","description":"Bridge configuration and withdrawal outcomes, with the claim proof for a single\nwithdrawal. Served by every node.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/v2/bridge/withdrawals/{account}":{"get":{"tags":["Bridge"],"summary":"List Account Withdrawals (v2)","operationId":"listAccountWithdrawalsV2","description":"As `/v2/bridge/withdrawals`, restricted to withdrawals debited from `account` (the\n`withdrawer`, which is the master for a delegated withdrawal).\n\nNo `Cache-Control` header is set.\n","parameters":[{"$ref":"#/components/parameters/AccountPath"},{"$ref":"#/components/parameters/MinTimestamp"},{"$ref":"#/components/parameters/WithdrawalSince"},{"$ref":"#/components/parameters/WithdrawalSinceId"},{"$ref":"#/components/parameters/WithdrawalLimit"}],"responses":{"200":{"description":"Withdrawal outcomes","content":{"application/json":{"schema":{"type":"object","required":["withdrawals","timestamp"],"properties":{"withdrawals":{"type":"array","items":{"$ref":"#/components/schemas/Withdrawal"}},"timestamp":{"$ref":"#/components/schemas/Timestamp","description":"Deadline of the newest tick whose outcomes the answering node serves. Never ahead of the rows. Pass it as `since` to `pod_withdrawals` to resume with no gap."}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/NodeBehind"}}}}},"components":{"parameters":{"AccountPath":{"name":"account","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Address"}},"MinTimestamp":{"name":"timestamp","in":"query","description":"The lowest tick deadline accepted, in microseconds — typically the highest `timestamp`\n(or `solution_now`) already held. The node answers once the state behind the route has\nreached it, otherwise `503` after its wait (default 2s, `POD_RPC_TIMESTAMP_WAIT`).\nOmitted means answer now.\n","schema":{"type":"integer","format":"int64"}},"WithdrawalSince":{"name":"since","in":"query","description":"Batch deadline in microseconds; returns outcomes strictly after it, or within it after `since_id`.","schema":{"type":"integer","format":"int64","default":0}},"WithdrawalSinceId":{"name":"since_id","in":"query","description":"Last `tx_hash` already seen within the `since` tick, to resume a page that ended mid-tick. Omit to resume after the whole tick.","schema":{"$ref":"#/components/schemas/Bytes32"}},"WithdrawalLimit":{"name":"limit","in":"query","description":"Page size. Values above 1000 are capped at 1000.","schema":{"type":"integer","minimum":0,"maximum":1000,"default":500}}},"schemas":{"Address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"20-byte address, `0x` hex"},"Bytes32":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"32-byte value, `0x` hex. Orderbook ids, order ids and hashes."},"Withdrawal":{"type":"object","description":"One withdrawal outcome, as `pod_withdrawals` delivers it.","required":["tx_hash","withdrawer","to","token","amount","timestamp_us"],"properties":{"tx_hash":{"$ref":"#/components/schemas/Bytes32","description":"The withdraw transaction's hash, the withdrawal's id."},"withdrawer":{"$ref":"#/components/schemas/Address","description":"The debited account; the master for a delegated withdrawal."},"to":{"$ref":"#/components/schemas/Address","description":"Recipient on the bridged chain."},"token":{"$ref":"#/components/schemas/Address","description":"Pod-side token."},"amount":{"$ref":"#/components/schemas/HexUint256","description":"Pod's 18 decimals, as signed. `claim` takes `proof.amount`."},"error":{"type":"string","enum":["insufficient_balance","not_included"],"description":"Why the withdrawal was refused. Omitted otherwise."},"timestamp_us":{"type":"integer","format":"int64","description":"The tick's batch deadline, microseconds. Also the `since` cursor."}}},"HexUint256":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"Unsigned 256-bit integer, `0x` hex"},"Timestamp":{"type":"integer","format":"int64","description":"Unix time in microseconds, as a JSON number"},"NodeBehindBody":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"$ref":"#/components/schemas/Timestamp","description":"The node's current value for the route."}}}},"responses":{"BadRequest":{"description":"Malformed path or query parameter. Plain-text reason.","content":{"text/plain":{"schema":{"type":"string"}}}},"InternalError":{"description":"The ledger read failed. Empty body."},"NodeBehind":{"description":"The node did not reach the requested `timestamp` within its wait; a value later than the node's clock plus the wait is rejected without waiting. Sent with `Retry-After: 1` and `Cache-Control: no-store`.","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeBehindBody"}}}}}}}
```

## Get Withdrawal and Claim Proof

> One withdrawal, keyed by the withdraw transaction's hash, with where it stands and\
> the claim proof once one can be assembled.\
> \
> \- \`claimable\`: \`proof\` is attached and the bridge contract will accept it.\
> \- \`pending\`: fewer than \`n - f\` signatures are held, or this node failed to\
> &#x20; assemble a proof it should have. The node asks its peers for the missing\
> &#x20; signatures itself; keep polling, or ask another node.\
> \- \`refused\`: refused at execution. Nothing was debited and no claim will exist;\
> &#x20; resubmitting yields a new \`tx\_hash\`. \`withdrawal.error\` usually names the\
> &#x20; reason but can be absent.\
> \
> Branch on the presence of \`proof\`: treat \`refused\` as terminal and anything else\
> as "ask again".\
> \
> \`404\` until the withdrawal has executed, a tick after admission.\
> \
> No \`Cache-Control\` header is set.<br>

```json
{"openapi":"3.0.0","info":{"title":"REST API","version":"1.0.0"},"tags":[{"name":"Bridge","description":"Bridge configuration and withdrawal outcomes, with the claim proof for a single\nwithdrawal. Served by every node.\n\n&nbsp; &nbsp; &nbsp;\n"}],"servers":[{"url":"https://staging-rpc.podtestnet.dev/v1","description":"Pod testnet"}],"paths":{"/bridge/withdrawals/by-id/{tx_hash}":{"get":{"tags":["Bridge"],"summary":"Get Withdrawal and Claim Proof","operationId":"getWithdrawalById","description":"One withdrawal, keyed by the withdraw transaction's hash, with where it stands and\nthe claim proof once one can be assembled.\n\n- `claimable`: `proof` is attached and the bridge contract will accept it.\n- `pending`: fewer than `n - f` signatures are held, or this node failed to\n  assemble a proof it should have. The node asks its peers for the missing\n  signatures itself; keep polling, or ask another node.\n- `refused`: refused at execution. Nothing was debited and no claim will exist;\n  resubmitting yields a new `tx_hash`. `withdrawal.error` usually names the\n  reason but can be absent.\n\nBranch on the presence of `proof`: treat `refused` as terminal and anything else\nas \"ask again\".\n\n`404` until the withdrawal has executed, a tick after admission.\n\nNo `Cache-Control` header is set.\n","parameters":[{"name":"tx_hash","in":"path","required":true,"description":"Hash of the withdraw transaction.","schema":{"$ref":"#/components/schemas/Bytes32"}}],"responses":{"200":{"description":"Withdrawal detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WithdrawalDetail"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"description":"No withdrawal with this id has executed on this node. Empty body."},"500":{"$ref":"#/components/responses/InternalError"}}}}},"components":{"schemas":{"Bytes32":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"32-byte value, `0x` hex. Orderbook ids, order ids and hashes."},"WithdrawalDetail":{"type":"object","required":["withdrawal","status"],"properties":{"withdrawal":{"$ref":"#/components/schemas/Withdrawal"},"status":{"type":"string","enum":["claimable","pending","refused"],"description":"May gain values. Treat an unfamiliar one as `pending`."},"proof":{"$ref":"#/components/schemas/BridgeClaimProof"}}},"Withdrawal":{"type":"object","description":"One withdrawal outcome, as `pod_withdrawals` delivers it.","required":["tx_hash","withdrawer","to","token","amount","timestamp_us"],"properties":{"tx_hash":{"$ref":"#/components/schemas/Bytes32","description":"The withdraw transaction's hash, the withdrawal's id."},"withdrawer":{"$ref":"#/components/schemas/Address","description":"The debited account; the master for a delegated withdrawal."},"to":{"$ref":"#/components/schemas/Address","description":"Recipient on the bridged chain."},"token":{"$ref":"#/components/schemas/Address","description":"Pod-side token."},"amount":{"$ref":"#/components/schemas/HexUint256","description":"Pod's 18 decimals, as signed. `claim` takes `proof.amount`."},"error":{"type":"string","enum":["insufficient_balance","not_included"],"description":"Why the withdrawal was refused. Omitted otherwise."},"timestamp_us":{"type":"integer","format":"int64","description":"The tick's batch deadline, microseconds. Also the `since` cursor."}}},"Address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"20-byte address, `0x` hex"},"HexUint256":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"Unsigned 256-bit integer, `0x` hex"},"BridgeClaimProof":{"type":"object","description":"Present exactly when `status` is `claimable`. Everything `claim(token, amount, to,\nproof, auxTxSuffix)` needs, except `token`: map the Pod-side `token` here to\n`l1_token` from `/bridge/config`.\n","required":["proof","committee_epoch","aux_tx_suffix"],"properties":{"proof":{"type":"array","items":{"type":"integer","minimum":0,"maximum":255},"description":"Certificate (`0x00` then one 65-byte signature per signer, by ascending signer address) or, for a withdrawal from before a bridge version bump, a Merkle proof."},"committee_epoch":{"type":"integer","format":"int64","description":"Currently always `0`."},"aux_tx_suffix":{"type":"array","items":{"type":"integer","minimum":0,"maximum":255},"description":"The withdrawal's id (its tx hash) as bytes."},"token":{"$ref":"#/components/schemas/Address","description":"Pod-side token. Omitted on legacy rows."},"amount":{"$ref":"#/components/schemas/HexUint256","description":"In the token's bridged-chain decimals; pass straight to `claim`. Omitted on legacy rows."},"to":{"$ref":"#/components/schemas/Address","description":"Recipient on the bridged chain. Omitted on legacy rows."},"claim_hash":{"$ref":"#/components/schemas/Bytes32","description":"The key `Bridge.processedRequests` uses; check it to see whether the claim already landed."}}}},"responses":{"BadRequest":{"description":"Malformed path or query parameter. Plain-text reason.","content":{"text/plain":{"schema":{"type":"string"}}}},"InternalError":{"description":"The ledger read failed. Empty body."}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.v2.pod.network/guides-references/references/rest/bridge.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
