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

# List onramp orders

> Newest first by when each order began.



## OpenAPI

````yaml https://raw.githubusercontent.com/rhinestonewtf/openapi/refs/heads/main/deposit-service.json get /onramp/orders
openapi: 3.1.0
info:
  title: Deposit Service API
  version: 1.0.0
  description: >-
    Rhinestone Deposits API: accept deposits from any chain, asset or payment
    method, and settle them as one token on one chain.
servers:
  - url: https://v1.orchestrator.rhinestone.dev/deposit-processor
security: []
paths:
  /onramp/orders:
    get:
      tags:
        - Onramp
      summary: List onramp orders
      description: Newest first by when each order began.
      parameters:
        - schema:
            type: string
            pattern: ^0x[a-fA-F0-9]{40}$
            description: Ethereum address (0x followed by 40 hex characters)
            example: '0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91'
          required: false
          description: Ethereum address (0x followed by 40 hex characters)
          name: account
          in: query
        - schema:
            type: string
            format: uuid
            description: '`nextCursor` of the previous page'
          required: false
          description: '`nextCursor` of the previous page'
          name: cursor
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
          required: false
          name: limit
          in: query
        - schema:
            type: string
            description: API key for authentication
            example: your-api-key
          required: true
          description: API key for authentication
          name: x-api-key
          in: header
      responses:
        '200':
          description: A page of orders
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OnrampOrderPage'
        '401':
          description: Authentication required or invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '403':
          description: API key lacks deposits:read
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '500':
          description: Internal failure serving the request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
components:
  schemas:
    OnrampOrderPage:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/OnrampOrder'
        nextCursor:
          type:
            - string
            - 'null'
          format: uuid
      required:
        - items
        - nextCursor
      additionalProperties: false
    OnrampOrder:
      type: object
      properties:
        id:
          type: string
          format: uuid
        provider:
          type: string
          enum:
            - noah
            - swapped
        kind:
          type: string
          enum:
            - fiat
            - exchange
        status:
          type: string
          enum:
            - pending
            - processing
            - completed
            - failed
            - refunded
        terminal:
          type: boolean
          description: No stage will change again
        stages:
          type: object
          properties:
            receipt:
              $ref: '#/components/schemas/OnrampReceiptStage'
            conversion:
              $ref: '#/components/schemas/OnrampConversionStage'
            delivery:
              $ref: '#/components/schemas/OnrampDeliveryStage'
            return:
              $ref: '#/components/schemas/OnrampReturnStage'
          required:
            - receipt
            - conversion
            - delivery
            - return
          additionalProperties: false
        rail:
          oneOf:
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - fiat
                method:
                  type: string
              required:
                - kind
                - method
              additionalProperties: false
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - exchange
                connection:
                  type: string
              required:
                - kind
                - connection
              additionalProperties: false
          description: '`provider_selected` / `unknown` when the provider did not say'
        fiat:
          type: object
          properties:
            charged:
              type:
                - object
                - 'null'
              properties:
                total:
                  type:
                    - string
                    - 'null'
                  description: Including fees
                net:
                  type:
                    - string
                    - 'null'
                  description: Before fees
                currency:
                  type: string
              required:
                - total
                - net
                - currency
              additionalProperties: false
              description: What the customer paid, in their own currency
            eur:
              type:
                - object
                - 'null'
              properties:
                total:
                  type:
                    - string
                    - 'null'
                  description: Including fees
                net:
                  type:
                    - string
                    - 'null'
                  description: Before fees
              required:
                - total
                - net
              additionalProperties: false
              description: Comparable across every order
            usd:
              type:
                - object
                - 'null'
              properties:
                total:
                  type:
                    - string
                    - 'null'
                  description: Including fees
                net:
                  type:
                    - string
                    - 'null'
                  description: Before fees
              required:
                - total
                - net
              additionalProperties: false
          required:
            - charged
            - eur
            - usd
          additionalProperties: false
          description: >-
            Each figure in a fixed currency; null when the provider did not
            state it
        crypto:
          type:
            - object
            - 'null'
          properties:
            asset:
              type: string
            network:
              type: string
            amount:
              type: string
          required:
            - asset
            - network
            - amount
          additionalProperties: false
        account:
          type: string
          pattern: ^0x[a-fA-F0-9]{40}$
          description: Ethereum address (0x followed by 40 hex characters)
          example: '0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91'
        deliveryAddress:
          type:
            - string
            - 'null'
          pattern: ^0x[a-fA-F0-9]{40}$
          description: Ethereum address (0x followed by 40 hex characters)
          example: '0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91'
        providerStatus:
          type: string
          description: The provider’s own status; informational
        createdAt:
          type: string
          format: date-time
          description: When the provider says the order began
        updatedAt:
          type: string
          format: date-time
      required:
        - id
        - provider
        - kind
        - status
        - terminal
        - stages
        - rail
        - fiat
        - crypto
        - account
        - deliveryAddress
        - providerStatus
        - createdAt
        - updatedAt
      additionalProperties: false
    OnrampReceiptStage:
      oneOf:
        - type: object
          properties:
            status:
              type: string
              enum:
                - not_started
          required:
            - status
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - pending
          required:
            - status
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - on_hold
            reason:
              type: string
              enum:
                - kyc_required
                - rfi_open
                - review
          required:
            - status
            - reason
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - processing
          required:
            - status
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - completed
          required:
            - status
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - failed
            reason:
              type: string
              enum:
                - cancelled
                - declined
                - expired
                - provider_error
          required:
            - status
            - reason
          additionalProperties: false
    OnrampConversionStage:
      oneOf:
        - type: object
          properties:
            status:
              type: string
              enum:
                - not_started
          required:
            - status
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - processing
          required:
            - status
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - on_hold
            reason:
              type: string
              enum:
                - rfi_open
                - review
          required:
            - status
            - reason
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - completed
          required:
            - status
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - failed
            reason:
              type: string
              enum:
                - sub_fee
                - provider_error
          required:
            - status
            - reason
          additionalProperties: false
    OnrampDeliveryStage:
      oneOf:
        - type: object
          properties:
            status:
              type: string
              enum:
                - not_started
          required:
            - status
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - pending
          required:
            - status
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - on_hold
            reason:
              type: string
              enum:
                - rfi_open
                - review
          required:
            - status
            - reason
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - submitted
            txHash:
              type: string
              pattern: ^0x[0-9a-f]{64}$
          required:
            - status
            - txHash
          additionalProperties: false
          description: The provider reported the transfer; not yet seen on chain
        - type: object
          properties:
            status:
              type: string
              enum:
                - completed
            txHash:
              type: string
              pattern: ^0x[0-9a-f]{64}$
            depositId:
              type: string
              description: The deposit it landed as
          required:
            - status
            - txHash
            - depositId
          additionalProperties: false
          description: The transfer landed on chain as a deposit
        - type: object
          properties:
            status:
              type: string
              enum:
                - failed
            reason:
              type: string
              enum:
                - sub_fee
                - provider_error
          required:
            - status
            - reason
          additionalProperties: false
    OnrampReturnStage:
      oneOf:
        - type: object
          properties:
            status:
              type: string
              enum:
                - none
          required:
            - status
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - pending
          required:
            - status
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - processing
          required:
            - status
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - completed
            outcome:
              type: string
              enum:
                - full_refund
                - adjustment
                - unresolved
          required:
            - status
            - outcome
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - failed
          required:
            - status
          additionalProperties: false

````