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

# Retrieve checkout deposit state

> Requires the deposit-specific status capability in the Bearer Authorization header. This capability remains valid after the checkout session and offer-acceptance deadline expire.




## OpenAPI

````yaml /openapi.yaml get /v1/checkout/deposits/{depositId}
openapi: 3.1.0
info:
  title: Skinloop API
  version: 1.1.0-draft
  description: |
    Public contract for Skinloop merchant payments, hosted checkout status,
    merchant dashboard reads, and merchant webhooks. Skinloop never exposes
    credentials, private identifiers, trade URLs, or client tokens.
servers:
  - url: https://api.skinloop.io
    description: Production
security: []
tags:
  - name: Payments
  - name: Checkout
  - name: Reporting
  - name: Dashboard
paths:
  /v1/checkout/deposits/{depositId}:
    get:
      tags:
        - Checkout
      summary: Retrieve checkout deposit state
      description: >
        Requires the deposit-specific status capability in the Bearer
        Authorization header. This capability remains valid after the checkout
        session and offer-acceptance deadline expire.
      operationId: getCheckoutDeposit
      parameters:
        - $ref: '#/components/parameters/DepositId'
      responses:
        '200':
          description: Session-owned deposit state
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutDepositStatus'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
      security:
        - checkoutBearer: []
components:
  parameters:
    DepositId:
      name: depositId
      in: path
      required: true
      schema:
        type: string
        pattern: ^dep_[A-Za-z0-9_-]{20,}$
  schemas:
    CheckoutDepositStatus:
      type: object
      description: >
        expiresAt is the checkout offer-acceptance deadline, not a status
        capability expiry. A valid statusToken remains usable after the checkout
        session expires so a protected trade can complete.
      additionalProperties: false
      required:
        - depositId
        - botDisplayName
        - botProfileUrl
        - items
        - total
        - requiredAmount
        - overpaymentMinor
        - currency
        - game
        - state
        - expiresAt
        - createdAt
        - updatedAt
        - pollAfterSeconds
        - reservationRequired
        - fulfillmentAllowed
        - holdUntil
        - warnings
      properties:
        depositId:
          type: string
          pattern: ^dep_[A-Za-z0-9_-]{20,}$
        botDisplayName:
          type:
            - string
            - 'null'
          maxLength: 200
        botProfileUrl:
          type:
            - string
            - 'null'
          pattern: ^https://steamcommunity\.com/profiles/[0-9]{17}$
        items:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/CheckoutInventoryItem'
        total:
          type: string
          pattern: ^(0\.[0-9]{2}|[1-9][0-9]*(\.[0-9]{2})?)$
        requiredAmount:
          type: string
          pattern: ^(0\.[0-9]{2}|[1-9][0-9]*(\.[0-9]{2})?)$
        overpaymentMinor:
          type: integer
          minimum: 0
        currency:
          type: string
          const: USD
        game:
          type: string
          enum:
            - cs2
            - rust
        state:
          type: string
          enum:
            - initiated
            - pending
            - active
            - hold
            - completed
            - canceled
            - declined
            - failed
            - reverted
            - expired
            - reconciliation_required
        expiresAt:
          type: string
          format: date-time
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
        pollAfterSeconds:
          type: integer
          minimum: 1
        statusToken:
          type: string
          pattern: ^st_[A-Za-z0-9_-]{43}$
          description: Returned on deposit creation and required for later status reads.
        reservationRequired:
          type: boolean
        fulfillmentAllowed:
          type: boolean
        holdUntil:
          type:
            - string
            - 'null'
          format: date-time
        warnings:
          type: array
          items:
            $ref: '#/components/schemas/MerchantWarning'
    CheckoutInventoryItem:
      type: object
      additionalProperties: false
      required:
        - id
        - asset_id
        - name
        - market_hash_name
        - icon_url
        - appid
        - tradable
        - offer
      properties:
        id:
          type: string
        asset_id:
          type: string
        name:
          type: string
        market_hash_name:
          type: string
        icon_url:
          type:
            - string
            - 'null'
          format: uri
        appid:
          type: integer
          enum:
            - 730
            - 252490
        tradable:
          type: boolean
          const: true
        exterior:
          type:
            - string
            - 'null'
        wear:
          type:
            - string
            - 'null'
        offer:
          type: object
          additionalProperties: false
          required:
            - accepted
            - available
            - price
            - price_minor
          properties:
            accepted:
              type: boolean
              const: true
            available:
              type: boolean
              const: true
            price:
              type: string
              pattern: ^(0\.[0-9]{2}|[1-9][0-9]*(\.[0-9]{2})?)$
            price_minor:
              type: integer
              minimum: 1
    MerchantWarning:
      type: object
      additionalProperties: false
      required:
        - code
        - severity
        - message
        - action
      properties:
        code:
          type: string
          enum:
            - checkout_expiring
            - selected_value_above_target
            - trade_pending
            - trade_hold_pending
            - reconciliation_required
        severity:
          type: string
          enum:
            - info
            - warning
            - action_required
        message:
          type: string
        action:
          type: string
        documentationUrl:
          type: string
          format: uri
        details:
          type: object
          additionalProperties:
            oneOf:
              - type: string
              - type: number
    Error:
      type: object
      additionalProperties: false
      required:
        - error
      properties:
        error:
          type: object
          additionalProperties: false
          required:
            - code
            - message
            - request_id
          properties:
            code:
              type: string
            message:
              type: string
            request_id:
              type: string
  responses:
    Unauthorized:
      description: Authentication or signature verification failed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: Checkout origin is not allowed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Resource not found or not visible to the caller
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: Rate limit exceeded
      headers:
        Retry-After:
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ServiceUnavailable:
      description: Checkout service is not configured or unavailable
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    checkoutBearer:
      type: http
      scheme: bearer
      bearerFormat: opaque checkout session or deposit status capability
      description: >
        Checkout creation uses the opaque ten-minute session token. Deposit
        status reads use the deposit-specific statusToken returned only by a
        successful deposit POST.

````