> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gelato.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# relayer_getStatus

> Fetches the current status of a previously submitted relayed transaction.



## OpenAPI

````yaml /gasless-with-relay/relayer-api-endpoints/relay/relayer_getStatus.json post /rpc
openapi: 3.1.0
info:
  title: relayer_getStatus
  version: 1.0.0
servers:
  - url: https://api.gelato.cloud
    description: Mainnet
security: []
paths:
  /rpc:
    post:
      summary: relayer_getStatus
      description: >-
        Fetches the current status of a previously submitted relayed
        transaction.
      parameters:
        - name: X-API-Key
          in: header
          required: true
          schema:
            type: string
          description: Gelato API key for authentication.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Request'
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    Request:
      type: object
      required:
        - jsonrpc
        - method
        - params
        - id
      properties:
        id:
          type: number
          default: 1
        jsonrpc:
          type: string
          default: '2.0'
        method:
          type: string
          default: relayer_getStatus
        params:
          $ref: '#/components/schemas/GetStatusParams'
    Response:
      type: object
      properties:
        id:
          type: number
          default: 1
        jsonrpc:
          type: string
          default: '2.0'
        result:
          $ref: '#/components/schemas/StatusResult'
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          default: '2.0'
        id:
          type: number
        error:
          type: object
          properties:
            code:
              type: number
              description: >-
                Error code (-32602: Invalid params, 4100: Unauthorized, 4208:
                Unknown Transaction ID)
            message:
              type: string
              description: Error message
    GetStatusParams:
      type: object
      required:
        - id
        - logs
      properties:
        id:
          type: string
          description: Task ID from relayer_sendTransaction
          default: '0x0e670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331'
        logs:
          type: boolean
          description: Include transaction logs in response
          default: false
    StatusResult:
      type: object
      properties:
        chainId:
          type: string
          description: Chain ID
          example: '137'
        createdAt:
          type: number
          description: Unix timestamp when task was created
          example: 1755917874
        status:
          type: number
          description: >-
            Status code: 100 (Pending), 110 (Submitted), 200 (Included), 400
            (Rejected), 500 (Reverted)
          example: 200
        hash:
          type: string
          description: Transaction hash (available when status >= 110)
          example: '0xd9b01a72502e7f518fb043bfacd1e13b07f24995f404f8cbb60a1212ca8b4c42'
        receipt:
          $ref: '#/components/schemas/Receipt'
        message:
          type: string
          description: Error message (available when status is 400 or 500)
          example: Insufficient payment amount
        data:
          type: object
          description: Additional error data (available when status is 400 or 500)
          example:
            required: '5.0'
            provided: '2.0'
    Receipt:
      type: object
      description: Transaction receipt (available when status is 200)
      properties:
        blockHash:
          type: string
          description: Block hash
          example: '0x6789b0746d84002f2f258129cfd9714d412e78b4d91b8e61608fac9165988baf'
        blockNumber:
          type: string
          description: Block number (hex)
          example: '0x22a1e6e'
        gasUsed:
          type: string
          description: Gas used (hex)
          example: '0x9cf2'
        transactionHash:
          type: string
          description: Transaction hash
          example: '0xd9b01a72502e7f518fb043bfacd1e13b07f24995f404f8cbb60a1212ca8b4c42'
        logs:
          type: array
          description: 'Event logs (if logs: true was requested)'
          items:
            type: object

````