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

# Get signed transaction details

> Retrieves details of a signed transaction. Only transactions belonging to the integrator can be accessed.



## OpenAPI

````yaml /api-reference/openapi.json get /transactions/sign/{transactionId}
openapi: 3.0.0
info:
  title: Relayer
  description: >-
    Relayer API — Kit-based crypto infrastructure for OTC exchange, wallet
    signing, payouts, and widget actions.
  version: '1.0'
  contact: {}
servers:
  - url: https://testnet.relayer.fi/v1
    description: Sandbox (testnet wallets, no real fiat)
  - url: https://api.relayer.fi/v1
    description: Production (mainnet wallets, regulated fiat rails)
security:
  - api-key: []
tags:
  - name: 'Action: Builders'
    description: Transaction metadata builders
  - name: 'Action: Directory'
    description: Widget directory
  - name: 'Action: Execute'
  - name: 'Action: Tokens'
    description: Token lists per chain/protocol
  - name: Addresses
  - name: Agents
  - name: App
    description: Application endpoints
  - name: 'Payout: Accounts'
    description: Payment execution
  - name: 'Payout: Off-ramp'
  - name: 'Payout: On-ramp'
  - name: 'Payout: Orders'
  - name: 'Payout: Recipients'
    description: Beneficiary management
  - name: Signing - Passkeys
  - name: Signing - Recovery
  - name: Signing Approvals
    description: Transaction signing approvals
  - name: Signing Policies
    description: Signing policy management
  - name: Transactions
    description: Transaction signing and broadcasting
  - name: Wallets
    description: Wallet and address management
paths:
  /transactions/sign/{transactionId}:
    get:
      tags:
        - Transactions
      summary: Get signed transaction details
      description: >-
        Retrieves details of a signed transaction. Only transactions belonging
        to the integrator can be accessed.
      operationId: TransactionsController_getSignedTransaction
      parameters:
        - name: transactionId
          required: true
          in: path
          description: Transaction ID
          schema:
            example: tx-uuid-abc123
            type: string
        - name: integratorId
          required: false
          in: query
          description: Integrator ID (required for ADMIN/INTERNAL scope)
          schema:
            example: uuid-integrator-id
            type: string
      responses:
        '200':
          description: Transaction retrieved successfully
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiResponseDto'
                  - properties:
                      data:
                        $ref: '#/components/schemas/SignedTransactionResponseDto'
        '403':
          description: Forbidden - Transaction does not belong to this integrator
        '404':
          description: Transaction not found
      security:
        - api-key: []
        - api-key: []
        - api-key: []
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |-
            curl https://api.relayer.fi/v1/transactions/sign/$TRANSACTION_ID \
              -H "Authorization: ApiKey $RELAYER_API_KEY"
        - lang: TypeScript
          label: Node.js
          source: >-
            const response = await fetch(
              `https://api.relayer.fi/v1/transactions/sign/${transactionId}`,
              { headers: { Authorization: `ApiKey ${process.env.RELAYER_API_KEY}` } },
            );

            const { data } = await response.json();

            // data.status: "awaiting_signature" | "signed" | "broadcast" |
            "confirmed" | "failed"
components:
  schemas:
    ApiResponseDto:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        data:
          type: object
        statusCode:
          type: number
        timestamp:
          type: string
        path:
          type: string
        traceId:
          type: string
      required:
        - success
        - message
        - statusCode
        - timestamp
    SignedTransactionResponseDto:
      type: object
      properties:
        transactionId:
          type: string
          description: Transaction ID for confirmation
          example: tx-uuid-abc123
        signedTransaction:
          type: string
          description: Signed transaction (hex string)
          example: 0x...
        status:
          type: string
          description: Transaction status
          example: pending
          enum:
            - pending
            - confirmed
            - broadcasted
            - failed
            - expired
            - cancelled
        from:
          type: string
          description: From address
          example: 0x123...
        to:
          type: string
          description: To address
          example: 0x456...
        amount:
          type: string
          description: Amount transferred
          example: '1.5'
        chainId:
          type: number
          description: Chain ID
          example: 43114
        tokenAddress:
          type: string
          description: Token address (if token transfer)
          example: 0x...
        expiresAt:
          type: string
          description: Expiration timestamp
          example: '2024-01-01T12:15:00Z'
        createdAt:
          type: string
          description: Creation timestamp
          example: '2024-01-01T12:00:00Z'
      required:
        - transactionId
        - signedTransaction
        - status
        - from
        - to
        - amount
        - chainId
        - expiresAt
        - createdAt
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: Authorization
      description: 'Use this format: `ApiKey <your_api_key>`'

````