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

# Get session receipt

> Read one receipt by the internal_uuid a start returned. The stop response carries the same receipt as cost. A session that is not yours answers 404 billing_session_not_found.



## OpenAPI

````yaml /api-reference/openapi.json get /billing/sessions/{session_uuid}
openapi: 3.1.0
info:
  title: Surfsky API
  version: 0.1.0
  description: >-
    Start cloud browsers, control them through CDP, and manage the profiles,
    proxies, and fingerprints they run with.
servers:
  - url: '{baseUrl}'
    variables:
      baseUrl:
        default: https://YOUR_API_HOST
        description: API base URL from your Surfsky dashboard, including https://.
security:
  - ApiToken: []
tags:
  - name: scrape
    description: >-
      Fetch one page through a browser that is already running: a residential
      proxy and a desktop fingerprint, nothing kept between requests.
  - name: profiles
    description: >-
      Start, stop, and manage browsers. A one-time profile is discarded when it
      stops; a persistent profile keeps its cookies, storage, and fingerprint
      according to its storage settings.
  - name: proxies
    description: >-
      Look up available proxy locations and check traffic quotas for the premium
      and shared pools.
  - name: fingerprints
    description: >-
      Look up accepted renderer, screen, and device model values before
      configuring a fingerprint.
  - name: extensions
    description: Upload Chrome extensions once and load them into any browser you start.
  - name: billing
    description: >-
      Read the balance, the receipt of every session and scrape, usage over time
      windows and the ledger of charges and top-ups.
  - name: site-reports
    description: Tell the Surfsky team about a website that keeps blocking your browsers.
paths:
  /billing/sessions/{session_uuid}:
    get:
      tags:
        - billing
      summary: Get session receipt
      description: >-
        Read one receipt by the internal_uuid a start returned. The stop
        response carries the same receipt as cost. A session that is not yours
        answers 404 billing_session_not_found.
      operationId: billing_session_get_billing_sessions__session_uuid__get
      parameters:
        - name: session_uuid
          in: path
          required: true
          schema:
            type: string
            title: Session Uuid
          description: The internal_uuid a start returned.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionReceipt'
        '401':
          description: Missing or invalid API token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '403':
          description: Account or feature access denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '404':
          description: >-
            No receipt for that session on your account
            (billing_session_not_found)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '422':
          description: Request validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
components:
  schemas:
    SessionReceipt:
      type: object
      properties:
        success:
          type: boolean
        msg:
          type: string
        data:
          type: object
          properties:
            session_uuid:
              type: string
              description: The internal_uuid the start returned.
            profile_uuid:
              type:
                - string
                - 'null'
              description: null for a one-time session or a scrape.
            status:
              type: string
              enum:
                - running
                - finalized
            finalized:
              type: boolean
              description: >-
                False while the session runs; the amounts are then what it would
                cost if it stopped now.
            started_at:
              type: integer
              description: Unix timestamp in seconds.
            ended_at:
              type:
                - integer
                - 'null'
              description: Unix timestamp in seconds.
            billed_seconds:
              type: integer
              description: >-
                Browser time in whole steps: a minute for a session, half a
                minute for a scrape, one step at least.
            billed_minutes:
              type: number
              description: billed_seconds in minutes; 0.5 for a 30-second scrape.
            browser_cost:
              type: string
              description: >-
                billed_seconds at the plan's browser-hour price; "0" on a
                reserved plan.
            total_cost:
              type: string
              description: >-
                Equals browser_cost. Traffic and captcha charges are ledger
                entries, not part of the receipt.
          required:
            - session_uuid
            - profile_uuid
            - status
            - finalized
            - started_at
            - ended_at
            - billed_seconds
            - billed_minutes
            - browser_cost
            - total_cost
      required:
        - success
        - data
    ApiError:
      type: object
      properties:
        success:
          type: boolean
          const: false
        msg:
          type: string
        code:
          type: string
        data: {}
        detail: {}
        error: {}
      description: >-
        Error fields vary for forwarded responses. Check HTTP status and code
        when present.
  securitySchemes:
    ApiToken:
      type: apiKey
      in: header
      name: X-Cloud-Api-Token
      description: API token from your dashboard.

````

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