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

# Get a tracked transaction status

> Returns the latest status stored by Delora's asynchronous tracking workers. It does not trigger an on-demand provider lookup.

Return the current lightweight tracking status for a source or destination transaction hash. Use this endpoint when polling an existing transaction instead of repeatedly fetching the full transaction object.

```bash theme={null}
curl 'https://api.delora.build/v1/transactions/0xSOURCE_OR_DESTINATION_HASH/status' \
  --header 'x-api-key: YOUR_API_KEY'
```

The response contains `id`, `transactionId`, source and destination hashes, `status`, `substatus`, `statusSource`, and `updatedAt`.

This reads the latest status stored by Delora's asynchronous workers; it does not trigger a live provider lookup. Use backoff between polls and handle `429` and `503` responses. See [status lifecycle semantics](/api-reference/transaction-tracking/overview#status-lifecycle).


## OpenAPI

````yaml GET /v1/transactions/{txHash}/status
openapi: 3.1.1
info:
  title: Delora API
  description: Delora API
  version: 1.0.0
servers:
  - url: https://api.delora.build
security: []
tags:
  - name: Health
    description: Service health endpoints.
  - name: V1
    description: Routing and metadata endpoints.
  - name: Transaction Tracking
    description: Read-only, integrator-scoped transaction tracking.
paths:
  /v1/transactions/{txHash}/status:
    get:
      tags:
        - Transaction Tracking
      summary: Get the lightweight current status of a tracked transaction
      description: >-
        Returns the latest status stored by Delora's asynchronous tracking
        workers. It does not trigger an on-demand provider lookup.
      operationId: getTransactionStatus
      parameters:
        - name: x-api-key
          in: header
          required: true
          description: Customer API key. Required for Transaction Tracking endpoints.
          schema:
            type: string
        - name: txHash
          in: path
          required: true
          description: Source or destination transaction hash.
          schema:
            type: string
            example: '0x596a6d35655f3d2d334abcffb6b69999b82d5661f18692ea24174589894a7d30'
      responses:
        '200':
          description: Lightweight transaction status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScannerTransactionStatusResponseDto'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponseDto'
        '404':
          description: >-
            No transaction is available for the hash in the current integrator
            scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponseDto'
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponseDto'
        '503':
          description: Transaction Tracking service is temporarily unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponseDto'
      security:
        - api-key: []
components:
  schemas:
    ScannerTransactionStatusResponseDto:
      type: object
      properties:
        id:
          type: string
        transactionId:
          type:
            - string
            - 'null'
        sourceTxHash:
          type: string
        destTxHash:
          type:
            - string
            - 'null'
        status:
          $ref: '#/components/schemas/ScannerStatus'
        substatus:
          type:
            - string
            - 'null'
        statusSource:
          $ref: '#/components/schemas/ScannerStatusSource'
        updatedAt:
          type: string
          format: date-time
      required:
        - id
        - transactionId
        - sourceTxHash
        - destTxHash
        - status
        - substatus
        - statusSource
        - updatedAt
    StandardErrorResponseDto:
      type: object
      properties:
        statusCode:
          type: number
          example: 400
        code:
          enum:
            - NO_AVAILABLE_QUOTES
            - AMOUNT_TOO_LOW
            - WRONG_ADDRESS
            - RATE_LIMIT
            - SLIPPAGE_EXCEEDED
            - ADAPTER_BAD_REQUEST
            - ADAPTER_UNAUTHORIZED
            - ADAPTER_INTERNAL
            - VALIDATION_ERROR
            - NOT_FOUND
            - UNKNOWN
          type: string
          description: >-
            Machine-readable Delora error code.

            - NO_AVAILABLE_QUOTES: No bridge or exchange adapter returned an
            executable quote for the requested transfer.

            - AMOUNT_TOO_LOW: The requested input amount is below the minimum
            supported by the available bridge route.

            - WRONG_ADDRESS: A wallet address is missing, malformed, or
            incompatible with the requested chain type.

            - RATE_LIMIT: The request exceeded the configured rate limit.

            - SLIPPAGE_EXCEEDED: The expected output amount fell below the
            route's permitted minimum.

            - ADAPTER_BAD_REQUEST: An upstream bridge or exchange adapter
            rejected the request as invalid.

            - ADAPTER_UNAUTHORIZED: An upstream bridge or exchange adapter
            rejected the request because credentials are missing or invalid.

            - ADAPTER_INTERNAL: An upstream bridge or exchange adapter failed
            with an internal error.

            - VALIDATION_ERROR: The request failed Delora API validation,
            including invalid query parameters, body fields, or address formats.

            - NOT_FOUND: The requested chain, token, or resource was not found.

            - UNKNOWN: The request failed with an unexpected error that does not
            map to a more specific code.
          x-enumDescriptions:
            - >-
              No bridge or exchange adapter returned an executable quote for the
              requested transfer.
            - >-
              The requested input amount is below the minimum supported by the
              available bridge route.
            - >-
              A wallet address is missing, malformed, or incompatible with the
              requested chain type.
            - The request exceeded the configured rate limit.
            - >-
              The expected output amount fell below the route's permitted
              minimum.
            - >-
              An upstream bridge or exchange adapter rejected the request as
              invalid.
            - >-
              An upstream bridge or exchange adapter rejected the request
              because credentials are missing or invalid.
            - >-
              An upstream bridge or exchange adapter failed with an internal
              error.
            - >-
              The request failed Delora API validation, including invalid query
              parameters, body fields, or address formats.
            - The requested chain, token, or resource was not found.
            - >-
              The request failed with an unexpected error that does not map to a
              more specific code.
          example: VALIDATION_ERROR
        message:
          type: string
          example: Invalid request parameters
        details:
          description: >-
            Optional error details. When details is an object, `message` can be
            either a string or an array of strings.
          oneOf:
            - type: object
              additionalProperties: true
              properties:
                message:
                  oneOf:
                    - type: string
                    - type: array
                      items:
                        type: string
                  description: >-
                    Human-readable details. Validation errors may return
                    multiple messages.
                errorCode:
                  type: string
                code:
                  oneOf:
                    - type: string
                    - type: number
                status:
                  oneOf:
                    - type: string
                    - type: number
            - type: string
            - type: array
              items:
                type: string
          example:
            message:
              - One or more request parameters are invalid.
        timestamp:
          type: string
          example: '2026-05-13T18:00:00.000Z'
        path:
          type: string
          example: /v1/...
      required:
        - statusCode
        - code
        - message
        - timestamp
    ScannerStatus:
      type: string
      enum:
        - success
        - recovered
        - bridge_pending
        - refund_pending
        - refunded
        - bridge_failed
        - unknown
      description: Current asynchronous tracking status.
    ScannerStatusSource:
      type: string
      enum:
        - analytics
        - receipt
        - bridge_api
        - mixed
        - unknown
      description: Source or combination of sources used for the current status.
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Delora API key. Required by Transaction Tracking endpoints and optional
        for most routing endpoints.

````