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

# Get Session

> Get session details by ID.

Returns full session details including status, payment info, and processor details.

**Authentication:** API Key (Bearer token)



## OpenAPI

````yaml /openapi.json get /v1/sessions/{session_id}
openapi: 3.1.0
info:
  title: Maven API
  description: >-
    Voice payment infrastructure — collect credit card payments securely over
    phone calls.
  version: 1.0.0
servers: []
security: []
paths:
  /v1/sessions/{session_id}:
    get:
      tags:
        - Public API (v1)
        - Sessions
      summary: Get Session
      description: >-
        Get session details by ID.


        Returns full session details including status, payment info, and
        processor details.


        **Authentication:** API Key (Bearer token)
      operationId: get_session_v1_sessions__session_id__get
      parameters:
        - name: session_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Session Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionGetResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - API Key: []
components:
  schemas:
    SessionGetResponse:
      properties:
        session_id:
          type: string
          title: Session Id
          description: Session UUID
        status:
          type: string
          title: Status
          description: Session status
        is_terminal:
          type: boolean
          title: Is Terminal
          description: Whether the session has reached a final state
        processor:
          anyOf:
            - $ref: '#/components/schemas/Processor'
            - type: 'null'
          description: Payment processor details
        error:
          anyOf:
            - $ref: '#/components/schemas/ErrorDetail'
            - type: 'null'
          description: Error details when status is payment-failed
        amount:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Amount
          description: Amount to charge
        currency:
          type: string
          title: Currency
          description: Currency code
        mode:
          type: string
          title: Mode
          description: Payment mode
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: Charge description
        caller:
          type: string
          title: Caller
          description: Phone number in E.164 format
        project_slug:
          type: string
          title: Project Slug
          description: Project slug
        gateway:
          type: string
          title: Gateway
          description: Payment gateway
        callback:
          anyOf:
            - type: string
            - type: 'null'
          title: Callback
          description: Callback phone number
        memory:
          anyOf:
            - type: string
            - type: 'null'
          title: Memory
          description: Call context passed back on transfer
        transfer_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Transfer Status
          description: Outcome of post-payment transfer-back dial
        created_at:
          type: string
          format: date-time
          title: Created At
          description: Creation timestamp
        updated_at:
          type: string
          format: date-time
          title: Updated At
          description: Last update timestamp
        expires_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Expires At
          description: When the session expires if unused
        completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Completed At
          description: When the session reached a terminal state
      type: object
      required:
        - session_id
        - status
        - is_terminal
        - amount
        - currency
        - mode
        - caller
        - project_slug
        - gateway
        - created_at
        - updated_at
      title: SessionGetResponse
      description: Full response for session details (GET endpoint).
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    Processor:
      properties:
        card_brand:
          anyOf:
            - type: string
            - type: 'null'
          title: Card Brand
          description: Card brand (visa, mastercard, etc.)
        card_last4:
          anyOf:
            - type: string
            - type: 'null'
          title: Card Last4
          description: Last 4 digits of the card
        receipt_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Receipt Url
          description: Stripe hosted receipt URL
        stripe_charge_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Stripe Charge Id
          description: Stripe Charge ID
        stripe_payment_intent_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Stripe Payment Intent Id
          description: Stripe PaymentIntent ID
        payment_method_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Payment Method Id
          description: Stripe PaymentMethod ID (tokenize mode, on connected account)
        stripe_customer_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Stripe Customer Id
          description: Stripe Customer ID on connected account (tokenize mode)
        authnet_transaction_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Authnet Transaction Id
          description: Authorize.net Transaction ID
        authnet_auth_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Authnet Auth Code
          description: Authorize.net Authorization Code
        authnet_response_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Authnet Response Code
          description: >-
            Authorize.net response code (1=Approved, 2=Declined, 3=Error,
            4=Held)
        authnet_avs_result_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Authnet Avs Result Code
          description: Authorize.net AVS (Address Verification) result code
        authnet_cvv_result_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Authnet Cvv Result Code
          description: Authorize.net CVV match result code
        authnet_cavv_result_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Authnet Cavv Result Code
          description: Authorize.net CAVV (3D Secure) result code
        authnet_network_trans_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Authnet Network Trans Id
          description: Card network transaction ID (Visa/Mastercard) for card-on-file flows
        authnet_capture_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Authnet Capture Status
          description: >-
            'captured' (auto) or 'authorized' (auth-only, awaiting manual
            capture)
        authnet_customer_profile_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Authnet Customer Profile Id
          description: Authorize.net CIM Customer Profile ID
        authnet_payment_profile_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Authnet Payment Profile Id
          description: Authorize.net CIM Payment Profile ID
        braintree_transaction_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Braintree Transaction Id
          description: Braintree Transaction ID
        braintree_customer_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Braintree Customer Id
          description: Braintree Customer ID (tokenize mode)
        braintree_payment_method_token:
          anyOf:
            - type: string
            - type: 'null'
          title: Braintree Payment Method Token
          description: Braintree Payment Method Token (tokenize mode)
        shift4_charge_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Shift4 Charge Id
          description: Shift4 Charge ID
        shift4_customer_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Shift4 Customer Id
          description: Shift4 Customer ID (tokenize mode)
        shift4_card_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Shift4 Card Id
          description: Shift4 Card ID (tokenize mode)
      type: object
      title: Processor
      description: Payment processor details.
    ErrorDetail:
      properties:
        code:
          type: string
          title: Code
          description: Machine-readable error code
        message:
          anyOf:
            - type: string
            - type: 'null'
          title: Message
          description: Human-readable error message
      type: object
      required:
        - code
      title: ErrorDetail
      description: Error information for failed sessions.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    API Key:
      type: http
      description: 'Enter your API key: mvn_test_xxx or mvn_live_xxx'
      scheme: bearer

````