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

# Poll the status of a gasless redeem

> Owner-scoped projection of the `redeem_positions` submitter job: pending → building → submitted → confirmed (or failed_permanent / expired). Returns 404 for an unknown id, a non-redeem job, or a job owned by another wallet (anti-enumeration).



## OpenAPI

````yaml /api-reference/openapi.json get /api/me/positions/redeem/{jobId}
openapi: 3.1.0
info:
  title: PredictStreet core-api
  description: >-
    Client-facing HTTP gateway for the PredictStreet prediction-market platform.
    **Partner kinds.** Every authenticated endpoint resolves a request's
    *effective wallet* from the partner row. `single_wallet` partners bind to
    one `associatedWallet` set at creation. `multi_wallet` partners declare the
    actor on every request via an `X-User-Wallet: 0x<40-hex>` header. See the
    [Partner kinds](/auth/api-keys#partner-kinds) doc for the full contract.
  version: '2026-04-25'
  contact:
    name: PredictStreet partners
    email: partners@predictstreet.com
servers:
  - url: https://core-api.adipredictstreet.com
    description: Production — replace with the API host issued at partner onboarding.
security: []
tags:
  - name: Events
    description: >-
      Polymarket-style event grouping with football metadata (group, stage,
      teams, tags).
  - name: Tags
    description: Curated tag taxonomy used to filter events.
  - name: Markets
    description: 'Public market data: list, detail, orderbook, trades, OHLC.'
  - name: Orders
    description: >-
      Signed-order place / cancel / read. Requires `X-Api-Key` with
      `orders:read` / `orders:write` scope; every write additionally requires an
      EIP-712 signature over the order.
  - name: Portfolio
    description: >-
      Balances, positions, trades, fees, vault info for the key's
      `associatedWallet`. Requires `X-Api-Key` with `portfolio:read` scope.
  - name: Matches
    description: >-
      admin.matches aggregate — groups several events into one fixture/card (1X2
      + first-scorer + over-under under one matchup).
  - name: Vault
    description: >-
      Backend co-signatures for ERC-1155 split / merge, and recovery for
      off-chain locks when the corresponding chain tx never confirmed. Requires
      `X-Api-Key` with `vault:write` scope plus an EIP-712 signature over the
      operation.
  - name: Leaderboard
    description: Public ranked leaderboard across PnL / volume buckets.
  - name: Search
    description: Global search across users, events, and matches.
paths:
  /api/me/positions/redeem/{jobId}:
    get:
      tags:
        - Portfolio
      summary: Poll the status of a gasless redeem
      description: >-
        Owner-scoped projection of the `redeem_positions` submitter job: pending
        → building → submitted → confirmed (or failed_permanent / expired).
        Returns 404 for an unknown id, a non-redeem job, or a job owned by
        another wallet (anti-enumeration).
      operationId: RedeemController_status
      parameters:
        - name: jobId
          in: path
          required: true
          schema:
            type: string
          description: Job id returned by the redeem call.
      responses:
        '200':
          description: Current job status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RedeemStatusRespDto'
        '404':
          description: Unknown / foreign / non-redeem job.
      security:
        - access: []
components:
  schemas:
    RedeemStatusRespDto:
      type: object
      properties:
        jobId:
          type: string
          description: Submitter job id (decimal string).
        status:
          type: string
          description: >-
            Job status: pending | building | submitted | confirmed |
            failed_permanent | expired.
        txHash:
          type: string
          description: On-chain hash once broadcast.
        submittedAt:
          type: string
          description: ISO-8601 broadcast timestamp (when the submitter sent the tx).
        confirmedAt:
          type: string
          description: ISO-8601 confirmation timestamp (receipt observed on-chain).
        lastError:
          type: string
          description: Last submitter error (populated on failed_permanent / retries).
      required:
        - jobId
        - status

````