> ## Documentation Index
> Fetch the complete documentation index at: https://algorand-54fd52b3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a receipt

> Receipt, settlement, rebate and refund status for a request id.



## OpenAPI

````yaml GET /v1/receipts/{id}
openapi: 3.1.0
info:
  title: Moltworld API
  version: 3.0.0
  description: >-
    Live Robinhood Chain deployment: chat requests are paid per call in WIF
    using x402 exact EVM/Permit2 on `eip155:4663`. Free model discovery and
    quotes are available. WIF is an 18-decimal ERC-20. Image, speech, video,
    marketplace listings and creator payouts, automatic WIF refunds/rebates, and
    autonomous agent mandates are not enabled. A paid chat request receives `402
    Payment Required` and must be retried with a valid EVM `Payment-Signature`;
    the signed challenge is authoritative for amount and recipient.
servers:
  - url: https://moltworldd.vercel.app
    description: Live WIF API
security: []
tags:
  - name: Models
    description: Chat is the only paid modality enabled on the Robinhood WIF deployment.
  - name: Pricing
  - name: Jobs and receipts
    description: >-
      Receipt lookup and signing keys are live. Video jobs are retained for
      legacy deployments only.
  - name: Mandates
    description: >-
      WIF GET lookup verifies a pinned owner-deployed contract. Setup, funding
      and revocation require the owner wallet; legacy Algorand POST routes
      remain unavailable on WIF.
  - name: Marketplace
    description: >-
      When ROBINHOOD_MARKETPLACE_ENABLED=true, approved real APIs support WIF
      checkout, exact creator credits and wallet-authorized verified payouts.
  - name: Service
paths:
  /v1/receipts/{id}:
    get:
      tags:
        - Jobs and receipts
      summary: Get a receipt
      description: Receipt, settlement, rebate and refund status for a request id.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Request id from `Moltworld-Request-Id`.
      responses:
        '200':
          description: Receipt
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReceiptLookup'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  schemas:
    ReceiptLookup:
      type: object
      properties:
        request_id:
          type: string
        status:
          type: string
          enum:
            - verified
            - settled
            - completed
            - failed
            - settle_failed
            - refund_pending
            - refunded
        receipt:
          oneOf:
            - $ref: '#/components/schemas/Receipt'
            - type: 'null'
        signature_valid:
          type: boolean
        amount:
          type: string
          description: >-
            USD quote in readable dollars; inspect receipt.amountAtomic for
            exact token base units.
        rebate:
          type: string
          description: Legacy rebate value; zero for the current Robinhood WIF chat flow.
        txid:
          type:
            - string
            - 'null'
        job:
          type:
            - object
            - 'null'
        refund:
          type:
            - object
            - 'null'
          description: >-
            Legacy refund metadata; the current WIF deployment does not run
            automatic refunds.
    Receipt:
      type: object
      description: >-
        Signed with Ed25519 over the canonical JSON (keys sorted, no whitespace)
        of every field except `sig`.
      properties:
        v:
          type: integer
          const: 1
        kid:
          type: string
        iss:
          type: string
        id:
          type: string
        network:
          type: string
        asset:
          type: string
        payer:
          type: string
        payTo:
          type: string
        amountMicro:
          type: integer
          description: USD quote in micro-dollars, not ERC-20 base units.
        txid:
          type: string
        resource:
          type: string
        model:
          type:
            - string
            - 'null'
        upstreamProvider:
          type:
            - string
            - 'null'
        upstreamModel:
          type:
            - string
            - 'null'
        requestSha256:
          type: string
        responseSha256:
          type: string
        rebateMicro:
          type: integer
          description: >-
            Legacy Algorand rebate field; zero for the current Robinhood WIF
            chat flow.
        issuedAt:
          type: integer
        sig:
          type: string
          description: base64url Ed25519 signature
        amountAtomic:
          type: string
          pattern: ^[0-9]+$
          description: Exact payment amount in the asset base units.
        assetDecimals:
          type: integer
        assetSymbol:
          type: string
        quotedUsdMicro:
          type: integer
          description: USD quote in micro-dollars.
        wifPrice:
          type: object
          properties:
            source:
              type: string
            priceUsd:
              type: string
            observedAt:
              type: string
              format: date-time
            liquidityUsd:
              type: number
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              example: validation_error
            message:
              type: string
          required:
            - code
            - message
      required:
        - error
  responses:
    NotFound:
      description: Unknown model, listing, job or receipt.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.