---
title: "Check a faucet transaction"
method: GET
path: "/api/faucets/{faucetId}/status"
tags: ["Faucets"]
---

# Check a faucet transaction

`GET /api/faucets/{faucetId}/status`

Looks up the receipt for a transaction hash returned by `sendFaucetFunds`. A hash the node has not seen yet reports `status: "pending"` with HTTP `200` — poll rather than treating it as an error.

## Path parameters

- `faucetId` 'ethereum-sepolia' | 'arbitrum-sepolia' | 'base-sepolia' | 'optimism-sepolia' | 'polygon-amoy' | 'zksync-sepolia' | 'worldchain-sepolia' | 'soneium-minato' | 'hyperliquid-testnet' | 'monad-testnet' | 'shape-sepolia' | 'abstract-testnet' | 'crossfi-testnet' | 'lens-sepolia' | 'syndicate-risa' | 'gensyn-testnet' | 'humanity-testnet' | 'worldl3-devnet' | 'stable-testnet' | 'starknet-sepolia' | 'unichain-sepolia' | 'ink-sepolia' | 'robinhood-testnet', required

## Query parameters

- `transactionHash` string, required

## Response `200`

Current state of the transaction.

- FaucetTransactionStatus — Either a mined receipt (`mined: true`) or a pending poll result.
  - `status` 'success' | 'failed' | 'pending', required — `pending` means the node has no receipt yet.
  - `mined` boolean — Present and `true` once a receipt exists.
  - `success` boolean — Present on the pending response.
  - `transactionHash` string
  - `chainId` integer
  - `chainName` string
  - `explorerUrl` string

## Other responses

- `400` — `transactionHash` missing or not a 32-byte hex hash, or unknown `faucetId`.
- `500` — The status check itself failed.

---

[API](https://skmtc.dev/alchemy/apis/alchemy-website-api.md) · [All operations](https://skmtc.dev/alchemy/apis/alchemy-website-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alchemy/alchemy-website-api/revisions/a80b50bbda9f/schema)