# starknet_getTransactionReceipt > For the complete documentation index, see [llms.txt](/docs/llms.txt). POST https://starknet-mainnet.g.alchemy.com/v2/{apiKey} Get the transaction receipt by the transaction hash Reference: https://www.alchemy.com/docs/chains/starknet/starknet-api-endpoints/starknet-get-transaction-receipt ## Parameters | Name | Type | Required | Description | |------|------|----------|-------------| | transaction_hash | string | Yes | The hash of the requested transaction | ## Result **result** (object) ## Code Examples ### cURL ```bash curl --request POST \ --url https://starknet-mainnet.g.alchemy.com/v2/docs-demo \ --header 'Content-Type: application/json' \ --data '{ "jsonrpc": "2.0", "id": 1, "method": "starknet_getTransactionReceipt", "params": [ "string" ] }' ``` ### JavaScript ```javascript const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'starknet_getTransactionReceipt', params: ['string'] }) }; fetch('https://starknet-mainnet.g.alchemy.com/v2/docs-demo', options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err)); ``` ### Python ```python import requests url = "https://starknet-mainnet.g.alchemy.com/v2/docs-demo" payload = { "jsonrpc": "2.0", "id": 1, "method": "starknet_getTransactionReceipt", "params": ["string"] } headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.text) ``` ### Go ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://starknet-mainnet.g.alchemy.com/v2/docs-demo" payload := strings.NewReader("{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"starknet_getTransactionReceipt\",\n \"params\": [\n \"string\"\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) } ``` ### Java ```java HttpResponse response = Unirest.post("https://starknet-mainnet.g.alchemy.com/v2/docs-demo") .header("Content-Type", "application/json") .body("{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"starknet_getTransactionReceipt\",\n \"params\": [\n \"string\"\n ]\n}") .asString(); ``` ### C# ```csharp using RestSharp; var options = new RestClientOptions("https://starknet-mainnet.g.alchemy.com/v2/docs-demo"); var client = new RestClient(options); var request = new RestRequest(""); request.AddJsonBody("{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"starknet_getTransactionReceipt\",\n \"params\": [\n \"string\"\n ]\n}", false); var response = await client.PostAsync(request); Console.WriteLine("{0}", response.Content); ``` ## OpenRPC Method Specification ```yaml name: starknet_getTransactionReceipt description: Get the transaction receipt by the transaction hash paramStructure: by-name params: - name: transaction_hash description: The hash of the requested transaction required: true schema: title: Transaction hash description: The transaction hash, as assigned in StarkNet type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ result: name: result schema: title: Transaction receipt with block info oneOf: - title: Invoke Transaction Receipt type: object required: - actual_fee - events - execution_resources - finality_status - messages_sent - transaction_hash - type description: Common properties for a transaction receipt oneOf: - title: Successful Common receipt properties description: Common properties for a transaction receipt that was executed successfully type: object required: - execution_status properties: execution_status: title: Execution status type: string enum: - SUCCEEDED description: The execution status of the transaction - title: Reverted Common receipt properties description: Common properties for a transaction receipt that was reverted type: object required: - execution_status - revert_reason properties: execution_status: title: Execution status type: string enum: - REVERTED description: The execution status of the transaction revert_reason: title: Revert reason description: The revert reason for the failed execution type: string properties: type: title: Type type: string enum: - INVOKE transaction_hash: title: Transaction hash description: The hash identifying the transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ actual_fee: title: Actual fee description: The fee that was charged by the sequencer type: object required: - amount - unit properties: amount: title: Amount description: Amount paid type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ unit: title: Fee unit description: Units in which the fee is given type: string enum: - WEI - FRI finality_status: title: Finality status description: Finality status of the transaction type: string enum: - ACCEPTED_ON_L2 - ACCEPTED_ON_L1 messages_sent: title: Messages sent type: array items: title: Message to L1 type: object required: - from_address - to_address - payload properties: from_address: title: Field element description: The address of the L2 contract sending the message type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ to_address: title: To address description: The target L1 address the message is sent to type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ payload: title: Payload description: The payload of the message type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ events: title: Events description: The events emitted as part of this transaction type: array items: title: Event description: A StarkNet event type: object required: - data - from_address - keys properties: from_address: title: From address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ keys: title: Keys type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ data: title: Data type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ execution_resources: title: Execution resources description: The resources consumed by the transaction type: object required: - data_availability - steps properties: steps: title: Steps description: The number of Cairo steps used type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 memory_holes: title: Memory holes description: The number of unused memory cells (each cell is roughly equivalent to a step) type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 range_check_builtin_applications: title: Range check applications description: The number of RANGE_CHECK builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 pedersen_builtin_applications: title: Pedersen applications description: The number of Pedersen builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 poseidon_builtin_applications: title: Poseidon applications description: The number of Poseidon builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 ec_op_builtin_applications: title: EC_OP applications description: The number of EC_OP builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 ecdsa_builtin_applications: title: ECDSA applications description: The number of ECDSA builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 bitwise_builtin_applications: title: BITWISE applications description: The number of BITWISE builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 keccak_builtin_applications: title: Keccak applications description: The number of KECCAK builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 segment_arena_builtin: title: Segment arena description: The number of accesses to the segment arena type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 data_availability: type: object required: - l1_gas - l1_data_gas properties: l1_gas: title: L1 Gas description: | The gas consumed by this transaction's data, 0 if it uses data gas for DA type: integer l1_data_gas: title: L1 Data Gas description: | The data gas consumed by this transaction's data, 0 if it uses gas for DA type: integer - title: L1 Handler Transaction Receipt description: Receipt for L1 handler transaction type: object required: - actual_fee - events - execution_resources - finality_status - message_hash - messages_sent - transaction_hash - type oneOf: - title: Successful Common receipt properties description: Common properties for a transaction receipt that was executed successfully type: object required: - execution_status properties: execution_status: title: Execution status type: string enum: - SUCCEEDED description: The execution status of the transaction - title: Reverted Common receipt properties description: Common properties for a transaction receipt that was reverted type: object required: - execution_status - revert_reason properties: execution_status: title: Execution status type: string enum: - REVERTED description: The execution status of the transaction revert_reason: title: Revert reason description: The revert reason for the failed execution type: string properties: type: title: Type type: string enum: - L1_HANDLER message_hash: title: Message hash description: The message hash as it appears on the L1 core contract type: string pattern: ^0x[a-fA-F0-9]+$ transaction_hash: title: Transaction hash description: The hash identifying the transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ actual_fee: title: Actual fee description: The fee that was charged by the sequencer type: object required: - amount - unit properties: amount: title: Amount description: Amount paid type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ unit: title: Fee unit description: Units in which the fee is given type: string enum: - WEI - FRI finality_status: title: Finality status description: Finality status of the transaction type: string enum: - ACCEPTED_ON_L2 - ACCEPTED_ON_L1 messages_sent: title: Messages sent type: array items: title: Message to L1 type: object required: - from_address - to_address - payload properties: from_address: title: Field element description: The address of the L2 contract sending the message type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ to_address: title: To address description: The target L1 address the message is sent to type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ payload: title: Payload description: The payload of the message type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ events: title: Events description: The events emitted as part of this transaction type: array items: title: Event description: A StarkNet event type: object required: - data - from_address - keys properties: from_address: title: From address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ keys: title: Keys type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ data: title: Data type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ execution_resources: title: Execution resources description: The resources consumed by the transaction type: object required: - data_availability - steps properties: steps: title: Steps description: The number of Cairo steps used type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 memory_holes: title: Memory holes description: The number of unused memory cells (each cell is roughly equivalent to a step) type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 range_check_builtin_applications: title: Range check applications description: The number of RANGE_CHECK builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 pedersen_builtin_applications: title: Pedersen applications description: The number of Pedersen builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 poseidon_builtin_applications: title: Poseidon applications description: The number of Poseidon builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 ec_op_builtin_applications: title: EC_OP applications description: The number of EC_OP builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 ecdsa_builtin_applications: title: ECDSA applications description: The number of ECDSA builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 bitwise_builtin_applications: title: BITWISE applications description: The number of BITWISE builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 keccak_builtin_applications: title: Keccak applications description: The number of KECCAK builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 segment_arena_builtin: title: Segment arena description: The number of accesses to the segment arena type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 data_availability: type: object required: - l1_gas - l1_data_gas properties: l1_gas: title: L1 Gas description: | The gas consumed by this transaction's data, 0 if it uses data gas for DA type: integer l1_data_gas: title: L1 Data Gas description: | The data gas consumed by this transaction's data, 0 if it uses gas for DA type: integer - title: Declare Transaction Receipt type: object required: - actual_fee - events - execution_resources - finality_status - messages_sent - transaction_hash - type description: Common properties for a transaction receipt oneOf: - title: Successful Common receipt properties description: Common properties for a transaction receipt that was executed successfully type: object required: - execution_status properties: execution_status: title: Execution status type: string enum: - SUCCEEDED description: The execution status of the transaction - title: Reverted Common receipt properties description: Common properties for a transaction receipt that was reverted type: object required: - execution_status - revert_reason properties: execution_status: title: Execution status type: string enum: - REVERTED description: The execution status of the transaction revert_reason: title: Revert reason description: The revert reason for the failed execution type: string properties: type: title: Declare type: string enum: - DECLARE transaction_hash: title: Transaction hash description: The hash identifying the transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ actual_fee: title: Actual fee description: The fee that was charged by the sequencer type: object required: - amount - unit properties: amount: title: Amount description: Amount paid type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ unit: title: Fee unit description: Units in which the fee is given type: string enum: - WEI - FRI finality_status: title: Finality status description: Finality status of the transaction type: string enum: - ACCEPTED_ON_L2 - ACCEPTED_ON_L1 messages_sent: title: Messages sent type: array items: title: Message to L1 type: object required: - from_address - to_address - payload properties: from_address: title: Field element description: The address of the L2 contract sending the message type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ to_address: title: To address description: The target L1 address the message is sent to type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ payload: title: Payload description: The payload of the message type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ events: title: Events description: The events emitted as part of this transaction type: array items: title: Event description: A StarkNet event type: object required: - data - from_address - keys properties: from_address: title: From address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ keys: title: Keys type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ data: title: Data type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ execution_resources: title: Execution resources description: The resources consumed by the transaction type: object required: - data_availability - steps properties: steps: title: Steps description: The number of Cairo steps used type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 memory_holes: title: Memory holes description: The number of unused memory cells (each cell is roughly equivalent to a step) type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 range_check_builtin_applications: title: Range check applications description: The number of RANGE_CHECK builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 pedersen_builtin_applications: title: Pedersen applications description: The number of Pedersen builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 poseidon_builtin_applications: title: Poseidon applications description: The number of Poseidon builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 ec_op_builtin_applications: title: EC_OP applications description: The number of EC_OP builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 ecdsa_builtin_applications: title: ECDSA applications description: The number of ECDSA builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 bitwise_builtin_applications: title: BITWISE applications description: The number of BITWISE builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 keccak_builtin_applications: title: Keccak applications description: The number of KECCAK builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 segment_arena_builtin: title: Segment arena description: The number of accesses to the segment arena type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 data_availability: type: object required: - l1_gas - l1_data_gas properties: l1_gas: title: L1 Gas description: | The gas consumed by this transaction's data, 0 if it uses data gas for DA type: integer l1_data_gas: title: L1 Data Gas description: | The data gas consumed by this transaction's data, 0 if it uses gas for DA type: integer - title: Deploy Transaction Receipt description: Common properties for a transaction receipt type: object required: - actual_fee - contract_address - events - execution_resources - finality_status - messages_sent - transaction_hash - type oneOf: - title: Successful Common receipt properties description: Common properties for a transaction receipt that was executed successfully type: object required: - execution_status properties: execution_status: title: Execution status type: string enum: - SUCCEEDED description: The execution status of the transaction - title: Reverted Common receipt properties description: Common properties for a transaction receipt that was reverted type: object required: - execution_status - revert_reason properties: execution_status: title: Execution status type: string enum: - REVERTED description: The execution status of the transaction revert_reason: title: Revert reason description: The revert reason for the failed execution type: string properties: transaction_hash: title: Transaction hash description: The hash identifying the transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ actual_fee: title: Actual fee description: The fee that was charged by the sequencer type: object required: - amount - unit properties: amount: title: Amount description: Amount paid type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ unit: title: Fee unit description: Units in which the fee is given type: string enum: - WEI - FRI finality_status: title: Finality status description: Finality status of the transaction type: string enum: - ACCEPTED_ON_L2 - ACCEPTED_ON_L1 messages_sent: title: Messages sent type: array items: title: Message to L1 type: object required: - from_address - to_address - payload properties: from_address: title: Field element description: The address of the L2 contract sending the message type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ to_address: title: To address description: The target L1 address the message is sent to type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ payload: title: Payload description: The payload of the message type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ events: title: Events description: The events emitted as part of this transaction type: array items: title: Event description: A StarkNet event type: object required: - data - from_address - keys properties: from_address: title: From address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ keys: title: Keys type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ data: title: Data type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ execution_resources: title: Execution resources description: The resources consumed by the transaction type: object required: - data_availability - steps properties: steps: title: Steps description: The number of Cairo steps used type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 memory_holes: title: Memory holes description: The number of unused memory cells (each cell is roughly equivalent to a step) type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 range_check_builtin_applications: title: Range check applications description: The number of RANGE_CHECK builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 pedersen_builtin_applications: title: Pedersen applications description: The number of Pedersen builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 poseidon_builtin_applications: title: Poseidon applications description: The number of Poseidon builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 ec_op_builtin_applications: title: EC_OP applications description: The number of EC_OP builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 ecdsa_builtin_applications: title: ECDSA applications description: The number of ECDSA builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 bitwise_builtin_applications: title: BITWISE applications description: The number of BITWISE builtin instances type: integer not: anyOf: - anyOf: - anyOf: - anyOf: - anyOf: - const: 0 # ... truncated (12685 chars) to keep this page under agent context limits. ```