> For the complete documentation index, see [llms.txt](https://docs.termina.technology/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.termina.technology/documentation/open-source-contributions/modules/data-anchor/indexing-data/getting-proofs/get_proof_request_status.md).

# get\_proof\_request\_status

## Retrieves the current status of a checkpoint proof request.

> \- Takes a \*\*request\_id\*\* returned by \`checkpoint\_proof\`.\
> \- Returns the status string (e.g. Created, InProgress, Succeeded, or Failed).\
> \
> This endpoint lets you monitor the lifecycle of a proof job.<br>

```json
{"openapi":"3.0.1","info":{"title":"Data Indexer — get_proof_request_status","version":"0.1.0"},"tags":[{"name":"Proofs","description":"Methods for initiating and tracking proof generation"}],"servers":[{"url":"https://devnet.data-anchor.termina.technology","description":"Devnet endpoint"}],"paths":{"/":{"post":{"tags":["Proofs"],"operationId":"getProofRequestStatus","summary":"Retrieves the current status of a checkpoint proof request.","description":"- Takes a **request_id** returned by `checkpoint_proof`.\n- Returns the status string (e.g. Created, InProgress, Succeeded, or Failed).\n\nThis endpoint lets you monitor the lifecycle of a proof job.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetProofRequestStatusRequest"}}}},"responses":{"200":{"description":"JSON-RPC success (status) or error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RpcResponse_GetProofRequestStatus"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"500":{"$ref":"#/components/responses/ServerError"}}}}},"components":{"schemas":{"GetProofRequestStatusRequest":{"allOf":[{"$ref":"#/components/schemas/RpcRequestBase"},{"type":"object","required":["params"],"properties":{"params":{"$ref":"#/components/schemas/GetProofRequestStatusParams"}}}]},"RpcRequestBase":{"type":"object","required":["id","jsonrpc","method"],"properties":{"id":{"type":"string","description":"Client-generated request ID"},"jsonrpc":{"type":"string","enum":["2.0"]},"method":{"type":"string","enum":["get_proof_request_status"]}}},"GetProofRequestStatusParams":{"type":"object","required":["request_id"],"properties":{"request_id":{"type":"string","description":"The proof request identifier returned by `checkpoint_proof`"}}},"RpcResponse_GetProofRequestStatus":{"type":"object","required":["jsonrpc","id"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"type":"string"},"result":{"type":"string","description":"Current status of the proof request.\nExamples: \"Created\", \"InProgress\", \"Succeeded\", \"Failed\".\n"},"error":{"$ref":"#/components/schemas/RpcError"}}},"RpcError":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{"type":"object","nullable":true}}}},"responses":{"BadRequest":{"description":"Invalid request payload or request_id format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RpcError"}}}},"ServerError":{"description":"Internal indexer error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RpcError"}}}}}}}
```

## The RpcRequestBase object

```json
{"openapi":"3.0.1","info":{"title":"Data Indexer — get_proof_request_status","version":"0.1.0"},"components":{"schemas":{"RpcRequestBase":{"type":"object","required":["id","jsonrpc","method"],"properties":{"id":{"type":"string","description":"Client-generated request ID"},"jsonrpc":{"type":"string","enum":["2.0"]},"method":{"type":"string","enum":["get_proof_request_status"]}}}}}}
```

## The GetProofRequestStatusParams object

```json
{"openapi":"3.0.1","info":{"title":"Data Indexer — get_proof_request_status","version":"0.1.0"},"components":{"schemas":{"GetProofRequestStatusParams":{"type":"object","required":["request_id"],"properties":{"request_id":{"type":"string","description":"The proof request identifier returned by `checkpoint_proof`"}}}}}}
```

## The GetProofRequestStatusRequest object

```json
{"openapi":"3.0.1","info":{"title":"Data Indexer — get_proof_request_status","version":"0.1.0"},"components":{"schemas":{"GetProofRequestStatusRequest":{"allOf":[{"$ref":"#/components/schemas/RpcRequestBase"},{"type":"object","required":["params"],"properties":{"params":{"$ref":"#/components/schemas/GetProofRequestStatusParams"}}}]},"RpcRequestBase":{"type":"object","required":["id","jsonrpc","method"],"properties":{"id":{"type":"string","description":"Client-generated request ID"},"jsonrpc":{"type":"string","enum":["2.0"]},"method":{"type":"string","enum":["get_proof_request_status"]}}},"GetProofRequestStatusParams":{"type":"object","required":["request_id"],"properties":{"request_id":{"type":"string","description":"The proof request identifier returned by `checkpoint_proof`"}}}}}}
```

## The RpcResponse\_GetProofRequestStatus object

```json
{"openapi":"3.0.1","info":{"title":"Data Indexer — get_proof_request_status","version":"0.1.0"},"components":{"schemas":{"RpcResponse_GetProofRequestStatus":{"type":"object","required":["jsonrpc","id"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"type":"string"},"result":{"type":"string","description":"Current status of the proof request.\nExamples: \"Created\", \"InProgress\", \"Succeeded\", \"Failed\".\n"},"error":{"$ref":"#/components/schemas/RpcError"}}},"RpcError":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{"type":"object","nullable":true}}}}}}
```

## The RpcError object

```json
{"openapi":"3.0.1","info":{"title":"Data Indexer — get_proof_request_status","version":"0.1.0"},"components":{"schemas":{"RpcError":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{"type":"object","nullable":true}}}}}}
```