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

# Get v1projects approval sessions



## OpenAPI

````yaml /openapi/platform.json get /v1/projects/{projectId}/approval-sessions
openapi: 3.1.0
info:
  title: GOL Platform API
  description: >-
    Versioned GOL developer and consumer API. Consumer routes are mounted when
    their runtime integrations are configured.
  version: 0.8.0-rc.1
servers:
  - url: http://localhost:4100
    description: Local development
security: []
tags:
  - name: system
  - name: authentication
  - name: projects
  - name: api-keys
  - name: audit
  - name: gas-executions
  - name: gas-policies
  - name: webhooks
paths:
  /v1/projects/{projectId}/approval-sessions:
    get:
      tags:
        - owner-approval
      operationId: listApprovalSessions
      parameters:
        - schema:
            format: uuid
            type: string
          in: path
          name: projectId
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                additionalProperties: false
                type: object
                required:
                  - data
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/def-18'
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                additionalProperties: false
                type: object
                required:
                  - error
                properties:
                  error:
                    additionalProperties: false
                    type: object
                    required:
                      - code
                      - message
                      - correlationId
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      correlationId:
                        format: uuid
                        type: string
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                additionalProperties: false
                type: object
                required:
                  - error
                properties:
                  error:
                    additionalProperties: false
                    type: object
                    required:
                      - code
                      - message
                      - correlationId
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      correlationId:
                        format: uuid
                        type: string
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                additionalProperties: false
                type: object
                required:
                  - error
                properties:
                  error:
                    additionalProperties: false
                    type: object
                    required:
                      - code
                      - message
                      - correlationId
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      correlationId:
                        format: uuid
                        type: string
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                additionalProperties: false
                type: object
                required:
                  - error
                properties:
                  error:
                    additionalProperties: false
                    type: object
                    required:
                      - code
                      - message
                      - correlationId
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      correlationId:
                        format: uuid
                        type: string
        '409':
          description: Default Response
          content:
            application/json:
              schema:
                additionalProperties: false
                type: object
                required:
                  - error
                properties:
                  error:
                    additionalProperties: false
                    type: object
                    required:
                      - code
                      - message
                      - correlationId
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      correlationId:
                        format: uuid
                        type: string
        '429':
          description: Default Response
          content:
            application/json:
              schema:
                additionalProperties: false
                type: object
                required:
                  - error
                properties:
                  error:
                    additionalProperties: false
                    type: object
                    required:
                      - code
                      - message
                      - correlationId
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      correlationId:
                        format: uuid
                        type: string
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                additionalProperties: false
                type: object
                required:
                  - error
                properties:
                  error:
                    additionalProperties: false
                    type: object
                    required:
                      - code
                      - message
                      - correlationId
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      correlationId:
                        format: uuid
                        type: string
        '503':
          description: Default Response
          content:
            application/json:
              schema:
                additionalProperties: false
                type: object
                required:
                  - error
                properties:
                  error:
                    additionalProperties: false
                    type: object
                    required:
                      - code
                      - message
                      - correlationId
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      correlationId:
                        format: uuid
                        type: string
      security:
        - bearerAuth: []
components:
  schemas:
    def-18:
      additionalProperties: false
      type: object
      required:
        - sessionId
        - requestId
        - projectId
        - environment
        - authorityFingerprint
        - state
        - version
        - createdAt
        - expiresAt
        - prepared
        - identity
        - destination
        - operation
      properties:
        sessionId:
          format: uuid
          type: string
        requestId:
          format: uuid
          type: string
        projectId:
          format: uuid
          type: string
        environment:
          type: string
          enum:
            - test
        authorityFingerprint:
          pattern: ^0x[0-9a-fA-F]{64}$
          type: string
        state:
          anyOf:
            - type: string
              enum:
                - pending
            - type: string
              enum:
                - rejected
            - type: string
              enum:
                - expired
            - type: string
              enum:
                - stale
            - type: string
              enum:
                - awaiting_broadcast
            - type: string
              enum:
                - observing
            - type: string
              enum:
                - indeterminate
            - type: string
              enum:
                - confirmed
        version:
          minimum: 1
          type: integer
        createdAt:
          format: date-time
          type: string
        expiresAt:
          format: date-time
          type: string
        prepared:
          anyOf:
            - additionalProperties: false
              type: object
              required:
                - draftId
                - draftExpiresAt
                - environment
                - chainId
                - core
                - account
                - family
                - review
                - authority
                - signing
                - submission
              properties:
                draftId:
                  format: uuid
                  type: string
                draftExpiresAt:
                  format: date-time
                  type: string
                environment:
                  type: string
                  enum:
                    - test
                chainId:
                  type: number
                  enum:
                    - 84532
                core:
                  pattern: ^0x[0-9a-fA-F]{40}$
                  type: string
                account:
                  pattern: ^0x[0-9a-fA-F]{40}$
                  type: string
                family:
                  anyOf:
                    - type: string
                      enum:
                        - safe
                    - type: string
                      enum:
                        - nexus
                    - type: string
                      enum:
                        - kernel
                    - type: string
                      enum:
                        - alchemy
                    - type: string
                      enum:
                        - nexus7702
                review:
                  additionalProperties: false
                  type: object
                  required:
                    - projectId
                    - contractProjectId
                    - agent
                    - asset
                    - assetDecimals
                    - recipients
                    - maxPerActionBaseUnits
                    - maxTotalBaseUnits
                    - relayerMode
                    - submitter
                    - gasRecipient
                    - attester
                    - maxGasPerActionWei
                    - maxGasTotalWei
                    - chargeableOutcomesMask
                    - maxDepth
                    - maxActiveDescendants
                    - mandateValidFrom
                    - mandateExpiresAt
                    - gasExpiresAt
                  properties:
                    projectId:
                      format: uuid
                      type: string
                    contractProjectId:
                      pattern: ^0x[0-9a-fA-F]{64}$
                      type: string
                    agent:
                      pattern: ^0x[0-9a-fA-F]{40}$
                      type: string
                    asset:
                      pattern: ^0x[0-9a-fA-F]{40}$
                      type: string
                    assetDecimals:
                      type: number
                      enum:
                        - 6
                    recipients:
                      type: array
                      items:
                        pattern: ^0x[0-9a-fA-F]{40}$
                        type: string
                    maxPerActionBaseUnits:
                      pattern: ^(0|[1-9][0-9]{0,77})$
                      type: string
                    maxTotalBaseUnits:
                      pattern: ^(0|[1-9][0-9]{0,77})$
                      type: string
                    relayerMode:
                      anyOf:
                        - type: string
                          enum:
                            - gol
                        - type: string
                          enum:
                            - developer
                    submitter:
                      pattern: ^0x[0-9a-fA-F]{40}$
                      type: string
                    gasRecipient:
                      pattern: ^0x[0-9a-fA-F]{40}$
                      type: string
                    attester:
                      pattern: ^0x[0-9a-fA-F]{40}$
                      type: string
                    maxGasPerActionWei:
                      pattern: ^(0|[1-9][0-9]{0,77})$
                      type: string
                    maxGasTotalWei:
                      pattern: ^(0|[1-9][0-9]{0,77})$
                      type: string
                    chargeableOutcomesMask:
                      minimum: 0
                      type: integer
                    maxDepth:
                      minimum: 0
                      type: integer
                    maxActiveDescendants:
                      minimum: 0
                      type: integer
                    mandateValidFrom:
                      minimum: 0
                      type: integer
                    mandateExpiresAt:
                      minimum: 0
                      type: integer
                    gasExpiresAt:
                      minimum: 0
                      type: integer
                authority:
                  additionalProperties: false
                  type: object
                  required:
                    - mandateTerms
                    - mandatePolicy
                    - gasPolicy
                    - mandateId
                    - gasPolicyId
                    - combinedDigest
                  properties:
                    mandateTerms:
                      additionalProperties: false
                      type: object
                      required:
                        - parentId
                        - account
                        - agent
                        - accountProfileId
                        - installEpoch
                        - projectId
                        - mode
                        - policyVersion
                        - policyHash
                        - validFrom
                        - expiresAt
                        - maxDepth
                        - maxActiveDescendants
                        - approvalExpiresAt
                        - salt
                      properties:
                        parentId:
                          pattern: ^0x[0-9a-fA-F]{64}$
                          type: string
                        account:
                          pattern: ^0x[0-9a-fA-F]{40}$
                          type: string
                        agent:
                          pattern: ^0x[0-9a-fA-F]{40}$
                          type: string
                        accountProfileId:
                          pattern: ^0x[0-9a-fA-F]{64}$
                          type: string
                        installEpoch:
                          pattern: ^(0|[1-9][0-9]{0,77})$
                          type: string
                        projectId:
                          pattern: ^0x[0-9a-fA-F]{64}$
                          type: string
                        mode:
                          minimum: 0
                          type: integer
                        policyVersion:
                          minimum: 0
                          type: integer
                        policyHash:
                          pattern: ^0x[0-9a-fA-F]{64}$
                          type: string
                        validFrom:
                          minimum: 0
                          type: integer
                        expiresAt:
                          minimum: 0
                          type: integer
                        maxDepth:
                          minimum: 0
                          type: integer
                        maxActiveDescendants:
                          minimum: 0
                          type: integer
                        approvalExpiresAt:
                          minimum: 0
                          type: integer
                        salt:
                          pattern: ^0x[0-9a-fA-F]{64}$
                          type: string
                    mandatePolicy:
                      pattern: ^0x([0-9a-f]{2})+$
                      type: string
                    gasPolicy:
                      additionalProperties: false
                      type: object
                      required:
                        - mandateId
                        - account
                        - projectId
                        - accountProfileId
                        - installEpoch
                        - feeAsset
                        - submitter
                        - recipient
                        - attester
                        - maxPerAction
                        - maxTotal
                        - expiresAt
                        - chargeableOutcomes
                        - formulaVersion
                        - nonce
                      properties:
                        mandateId:
                          pattern: ^0x[0-9a-fA-F]{64}$
                          type: string
                        account:
                          pattern: ^0x[0-9a-fA-F]{40}$
                          type: string
                        projectId:
                          pattern: ^0x[0-9a-fA-F]{64}$
                          type: string
                        accountProfileId:
                          pattern: ^0x[0-9a-fA-F]{64}$
                          type: string
                        installEpoch:
                          pattern: ^(0|[1-9][0-9]{0,77})$
                          type: string
                        feeAsset:
                          pattern: ^0x[0-9a-fA-F]{40}$
                          type: string
                        submitter:
                          pattern: ^0x[0-9a-fA-F]{40}$
                          type: string
                        recipient:
                          pattern: ^0x[0-9a-fA-F]{40}$
                          type: string
                        attester:
                          pattern: ^0x[0-9a-fA-F]{40}$
                          type: string
                        maxPerAction:
                          pattern: ^(0|[1-9][0-9]{0,77})$
                          type: string
                        maxTotal:
                          pattern: ^(0|[1-9][0-9]{0,77})$
                          type: string
                        expiresAt:
                          minimum: 0
                          type: integer
                        chargeableOutcomes:
                          minimum: 0
                          type: integer
                        formulaVersion:
                          minimum: 0
                          type: integer
                        nonce:
                          pattern: ^(0|[1-9][0-9]{0,77})$
                          type: string
                    mandateId:
                      pattern: ^0x[0-9a-fA-F]{64}$
                      type: string
                    gasPolicyId:
                      pattern: ^0x[0-9a-fA-F]{64}$
                      type: string
                    combinedDigest:
                      pattern: ^0x[0-9a-fA-F]{64}$
                      type: string
                signing:
                  $ref: '#/components/schemas/def-5'
                submission:
                  additionalProperties: false
                  type: object
                  required:
                    - to
                    - functionName
                  properties:
                    to:
                      pattern: ^0x[0-9a-fA-F]{40}$
                      type: string
                    functionName:
                      type: string
                      enum:
                        - createMandateWithGas
            - additionalProperties: false
              type: object
              required:
                - action
                - draftId
                - draftExpiresAt
                - environment
                - chainId
                - core
                - account
                - family
                - review
                - deadline
                - installEpoch
                - nonce
                - gasPolicyId
                - mandateId
                - ownerCall
                - safePreviousModule
                - execution
                - signing
                - expectedHash
                - ownerConfiguration
                - setup
              properties:
                action:
                  anyOf:
                    - type: string
                      enum:
                        - pause
                    - type: string
                      enum:
                        - resume
                    - type: string
                      enum:
                        - revoke
                    - type: string
                      enum:
                        - gas_revoke
                    - type: string
                      enum:
                        - install
                    - type: string
                      enum:
                        - remove
                    - type: string
                      enum:
                        - eip7702_setup
                draftId:
                  format: uuid
                  type: string
                draftExpiresAt:
                  format: date-time
                  type: string
                environment:
                  type: string
                  enum:
                    - test
                chainId:
                  type: number
                  enum:
                    - 84532
                core:
                  pattern: ^0x[0-9a-fA-F]{40}$
                  type: string
                account:
                  pattern: ^0x[0-9a-fA-F]{40}$
                  type: string
                family:
                  anyOf:
                    - type: string
                      enum:
                        - safe
                    - type: string
                      enum:
                        - nexus
                    - type: string
                      enum:
                        - kernel
                    - type: string
                      enum:
                        - alchemy
                    - type: string
                      enum:
                        - nexus7702
                review:
                  additionalProperties: false
                  type: object
                  required:
                    - projectId
                  properties:
                    projectId:
                      format: uuid
                      type: string
                deadline:
                  type: integer
                installEpoch:
                  pattern: ^(0|[1-9][0-9]*)$
                  type: string
                nonce:
                  pattern: ^(0|[1-9][0-9]*)$
                  type: string
                gasPolicyId:
                  anyOf:
                    - pattern: ^0x[0-9a-fA-F]{64}$
                      type: string
                    - type: 'null'
                mandateId:
                  anyOf:
                    - pattern: ^0x[0-9a-fA-F]{64}$
                      type: string
                    - type: 'null'
                ownerCall:
                  anyOf:
                    - additionalProperties: false
                      type: object
                      required:
                        - to
                        - data
                        - operation
                      properties:
                        to:
                          pattern: ^0x[0-9a-fA-F]{40}$
                          type: string
                        data:
                          type: string
                        operation:
                          anyOf:
                            - type: number
                              enum:
                                - 0
                            - type: number
                              enum:
                                - 1
                    - type: 'null'
                safePreviousModule:
                  anyOf:
                    - pattern: ^0x[0-9a-fA-F]{40}$
                      type: string
                    - type: 'null'
                execution:
                  anyOf:
                    - additionalProperties: false
                      type: object
                      required:
                        - kind
                        - nonce
                        - typedData
                        - userOperation
                      properties:
                        kind:
                          anyOf:
                            - type: string
                              enum:
                                - safe_transaction
                            - type: string
                              enum:
                                - user_operation
                            - type: string
                              enum:
                                - eoa_transaction
                        nonce:
                          pattern: ^(0|[1-9][0-9]*)$
                          type: string
                        typedData:
                          anyOf:
                            - type: object
                              additionalProperties: {}
                            - type: 'null'
                        userOperation:
                          anyOf:
                            - type: object
                              additionalProperties:
                                type: string
                            - type: 'null'
                    - type: 'null'
                signing:
                  anyOf:
                    - type: object
                      additionalProperties: {}
                    - type: 'null'
                expectedHash:
                  anyOf:
                    - pattern: ^0x[0-9a-fA-F]{64}$
                      type: string
                    - type: 'null'
                ownerConfiguration:
                  additionalProperties: false
                  type: object
                  required:
                    - owners
                    - threshold
                    - fingerprint
                  properties:
                    owners:
                      minItems: 1
                      type: array
                      items:
                        pattern: ^0x[0-9a-fA-F]{40}$
                        type: string
                    threshold:
                      minimum: 1
                      type: integer
                    fingerprint:
                      pattern: ^0x[0-9a-fA-F]{64}$
                      type: string
                setup:
                  anyOf:
                    - type: object
                      additionalProperties: {}
                    - type: 'null'
        ownerConfiguration:
          additionalProperties: false
          type: object
          required:
            - owners
            - threshold
            - fingerprint
          properties:
            owners:
              minItems: 1
              type: array
              items:
                pattern: ^0x[0-9a-fA-F]{40}$
                type: string
            threshold:
              minimum: 1
              type: integer
            fingerprint:
              pattern: ^0x[0-9a-fA-F]{64}$
              type: string
        signatures:
          additionalProperties: false
          type: object
          required:
            - signers
            - threshold
          properties:
            signers:
              type: array
              items:
                type: string
            threshold:
              type: integer
        identity:
          additionalProperties: false
          type: object
          required:
            - projectId
            - name
            - domain
            - domainVerifiedAt
          properties:
            projectId:
              format: uuid
              type: string
            name:
              type: string
            domain:
              type: string
            domainVerifiedAt:
              format: date-time
              type: string
        destination:
          additionalProperties: false
          type: object
          required:
            - id
            - origin
            - returnUrl
            - active
          properties:
            id:
              format: uuid
              type: string
            origin:
              type: string
            returnUrl:
              type: string
            active:
              type: boolean
        operation:
          anyOf:
            - additionalProperties: false
              type: object
              required:
                - id
                - acceptedAt
                - transactionHash
                - inclusion
                - currentMandateStatus
                - errorCode
              properties:
                id:
                  format: uuid
                  type: string
                acceptedAt:
                  format: date-time
                  type: string
                transactionHash:
                  anyOf:
                    - pattern: ^0x[0-9a-fA-F]{64}$
                      type: string
                    - type: 'null'
                inclusion:
                  anyOf:
                    - type: string
                    - type: 'null'
                currentMandateStatus:
                  anyOf:
                    - type: string
                    - type: 'null'
                errorCode:
                  anyOf:
                    - type: string
                    - type: 'null'
            - type: 'null'
      title: ApprovalSession
    def-5:
      additionalProperties: false
      type: object
      required:
        - family
        - method
        - typedData
        - expectedHash
        - digest
        - signatureFormat
      properties:
        family:
          anyOf:
            - type: string
              enum:
                - safe
            - type: string
              enum:
                - nexus
            - type: string
              enum:
                - kernel
            - type: string
              enum:
                - alchemy
            - type: string
              enum:
                - nexus7702
        method:
          type: string
          enum:
            - eth_signTypedData_v4
        typedData:
          additionalProperties: false
          type: object
          required:
            - domain
            - types
            - primaryType
            - message
          properties:
            domain:
              type: object
              additionalProperties: {}
            types:
              type: object
              additionalProperties:
                type: array
                items:
                  type: object
                  required:
                    - name
                    - type
                  properties:
                    name:
                      type: string
                    type:
                      type: string
            primaryType:
              type: string
            message:
              type: object
              additionalProperties: {}
        expectedHash:
          pattern: ^0x[0-9a-fA-F]{64}$
          type: string
        digest:
          pattern: ^0x[0-9a-fA-F]{64}$
          type: string
        signatureFormat:
          anyOf:
            - type: string
              enum:
                - safe_threshold
            - type: string
              enum:
                - nexus_k1
            - type: string
              enum:
                - kernel_root
            - type: string
              enum:
                - alchemy_entity_zero
            - type: string
              enum:
                - eoa
      title: WalletSigningPayload
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Opaque owner, CLI, or agent session token. Agent tokens are accepted
        only where marked.

````

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