Volt

Volt Accounts API

The Accounts API powers Volt Accounts and virtual IBANs for settlement, collections, payouts and refunds, giving merchants programmatic named accounts for receiving and disbursing funds within the Volt network.

GitHub OpenAPI

Documentation

📖
Documentation
https://docs.volt.io/implementation/volt-accounts
📖
APIReference
https://docs.volt.io/api-reference/accounts

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/volt-io/refs/heads/main/openapi/volt-io-accounts-openapi-original.yaml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/volt-io/refs/heads/main/overlays/volt-io-accounts-overlay.yaml
🔗
MCPServer
https://raw.githubusercontent.com/api-evangelist/volt-io/refs/heads/main/mcp/volt-io-mcp.yml
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/volt-io/refs/heads/main/mcp/volt-io-tool-crosswalk.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/volt-io/refs/heads/main/data-model/volt-io-data-model.yml

OpenAPI Specification

volt-io-accounts-openapi-original.yaml Raw ↑ 
openapi: 3.0.1
info:
  title: Global Api Accounts
  version: 1.0.0
  description: |-
    ## API idempotency 
    Each `POST` request creating a resource (for example a transaction) requires to send a unique idempotency key. It is included in the `Idempotency-Key` HTTP header. Idempotency key helps prevent duplicates in your `POST` requests. We recommend using an **UUID** for the key, however you may use any other unique identifier you choose.

    #### Preventing duplicates 
    If we have already processed the request and you send a request using the same idempotency key, it will fail with an error, returning a ```409 Conflict``` response.

    ## Case-sensitivity
    All properties/keys within request's/response's payload are case-sensitive.

    HTTP headers' names are case-insensitive.

    ## API base URL
    **Sandbox: [https://accounts.sandbox.volt.io]()**

    **Production: [https://accounts.volt.io]()**
  contact:
    email: support@volt.io
    name: Volt Support
    url: 'https://www.volt.io/contact/'
servers:
  - url: 'https://accounts.sandbox.volt.io'
    description: Sandbox
  - url: 'https://accounts.volt.io'
    description: Production
tags:
  - name: Transactions
    description: 'Operations related to movement of funds, including payouts, settlements, and internal transactions.'
  - name: Accounts
    description: Management of accounts.
  - name: Aliases
    description: Issuance and management of account aliases for global reconciliation.
  - name: Account Holder Verification
    description: Verification services for ensuring beneficiary account ownership.
  - name: Trusted accounts
    description: Operations related to trusted accounts.
  - name: Named Accounts
    description: Named account order operations.
  - name: Sandbox
    description: Operations related to sandbox operations.
security:
  - BearerAuth: []
paths:
  #
  # Operations related to Transactions
  #
  /transactions:
    get:
      summary: List of transactions
      operationId: get-transactions
      tags:
        - Transactions
      parameters:
        - $ref: '#/components/parameters/XVoltApiVersion'
        - $ref: '#/components/parameters/LimitParam'
        - $ref: '#/components/parameters/PageParam'
        - in: query
          name: 'status[]'
          description: 'Filter by transaction status (e.g. COMPLETED, REJECTED).'
          schema:
            type: array
            items:
              $ref: '#/components/schemas/TransactionStatusEnum'
            example:
              - CREATED
        - in: query
          name: 'createdAt[gte]'
          description: Filter for transactions created on or after this date.
          schema:
            type: string
            format: date-time
            description: 'ISO 8601 format (YYYY-MM-DDThh:mm:ssZ)'
            example: '2025-07-01T10:00:00Z'
        - in: query
          name: 'operation[]'
          description: Filter by operation direction (INCOMING or OUTGOING).
          schema:
            type: array
            items:
              $ref: '#/components/schemas/TransactionOperationEnum'
            example:
              - OUTGOING
        - in: query
          name: 'type[]'
          description: Filter by transaction type.
          schema:
            type: array
            items:
              $ref: '#/components/schemas/TransactionTypeEnum'
            example:
              - PAYOUT
        - in: query
          name: accountId
          description: Filter by account.
          schema:
            type: string
            format: uuid
            example: 2f5e48b7-235a-4ba4-ad10-8aa981a73d03
        - in: query
          name: sourceTransactionId
          description: Filter by source transaction id (e.g. for refunds).
          schema:
            type: string
            format: uuid
            example: 2f5e48b7-235a-4ba4-ad10-8aa981a73d03
        - in: query
          name: aliasId
          description: Filter transactions by alias UUID.
          schema:
            type: string
            format: uuid
            example: f47ac10b-58cc-4372-a567-0e02b2c3d479
        - in: query
          name: gatewayPaymentId
          description: Filter transactions by linked gateway payment UUID.
          schema:
            type: string
            format: uuid
            example: f47ac10b-58cc-4372-a567-0e02b2c3d479
        - in: query
          name: iban
          description: 'Filter by exact IBAN. Matches the beneficiary, beneficiary alias or sender identification.'
          schema:
            type: string
            example: DE07500105176551562526
        - in: query
          name: accountNumber
          description: 'Filter by exact account number. Matches the beneficiary, beneficiary alias or sender identification.'
          schema:
            type: string
            example: '12345678'
        - in: query
          name: 'order[createdAt]'
          description: Sort order by createdAt field (desc by default).
          schema:
            allOf:
              - $ref: '#/components/schemas/SortOrder'
      responses:
        '200':
          description: Paginated list of transactions.
          headers:
            limit:
              $ref: '#/components/headers/PaginationLimit'
            page:
              $ref: '#/components/headers/PaginationPage'
            page-count:
              $ref: '#/components/headers/PaginationPageCount'
            total-items:
              $ref: '#/components/headers/PaginationTotalItems'
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TransactionMinimalDetails'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '415':
          $ref: '#/components/responses/415'
        '422':
          $ref: '#/components/responses/422'
        '500':
          $ref: '#/components/responses/500'
  '/transactions/{transactionId}':
    get:
      summary: Get transaction details
      operationId: get-transaction-details
      tags:
        - Transactions
      parameters:
        - $ref: '#/components/parameters/XVoltApiVersion'
        - name: transactionId
          in: path
          description: Unique UUID of the transaction.
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Full details of the specified transaction.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDetails'
              examples:
                Outgoing:
                  $ref: '#/components/examples/OutgoingResponseExample'
                Incoming:
                  $ref: '#/components/examples/IncomingResponseExample'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '415':
          $ref: '#/components/responses/415'
        '422':
          $ref: '#/components/responses/422'
        '500':
          $ref: '#/components/responses/500'
  '/accounts/{accountId}/transactions':
    post:
      summary: Create a transaction
      operationId: create-transaction
      tags:
        - Transactions
      parameters:
        - name: accountId
          in: path
          description: Unique identifier of the account.
          required: true
          schema:
            type: string
            format: uuid
        - $ref: '#/components/parameters/IdempotencyKey'
        - $ref: '#/components/parameters/XVoltApiVersion'
        - $ref: '#/components/parameters/XJWSSignature'
        - $ref: '#/components/parameters/XVoltTestingScenario'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required:
                - type
              properties:
                type:
                  type: string
                  description: 'The transaction type discriminator (PAYOUT, SETTLEMENT, INTERNAL, or REFUND).'
              oneOf:
                - $ref: '#/components/schemas/SettlementTransactionRequest'
                - $ref: '#/components/schemas/PayoutTransactionRequest'
                - $ref: '#/components/schemas/InternalTransactionRequest'
                - $ref: '#/components/schemas/RefundTransactionRequest'
              discriminator:
                propertyName: type
                mapping:
                  PAYOUT: '#/components/schemas/PayoutTransactionRequest'
                  SETTLEMENT: '#/components/schemas/SettlementTransactionRequest'
                  INTERNAL: '#/components/schemas/InternalTransactionRequest'
                  REFUND: '#/components/schemas/RefundTransactionRequest'
            examples:
              payoutRequestEURExample:
                $ref: '#/components/examples/PayoutRequestEURExample'
              payoutRequestGBPExample:
                $ref: '#/components/examples/PayoutRequestGBPExample'
              settlementRequestEURExample:
                $ref: '#/components/examples/SettlementRequestEURExample'
              internalRequestEURExample:
                $ref: '#/components/examples/InternalRequestEURExample'
              refundRequestExample:
                $ref: '#/components/examples/RefundRequestExample'
      responses:
        '201':
          description: Transaction created successfully.
          headers:
            Location:
              schema:
                type: string
                format: uri
              description: Location of created transaction
          content:
            application/json:
              schema:
                type: object
                description: Response containing the identifier of the created transaction.
                properties:
                  id:
                    type: string
                    format: uuid
                    description: Unique ID of the transaction.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '409':
          $ref: '#/components/responses/409'
        '415':
          $ref: '#/components/responses/415'
        '422':
          $ref: '#/components/responses/422'
        '500':
          $ref: '#/components/responses/500'
  #
  # Operations related to Account Holder Verifications
  #
  '/account-holder-verifications/{id}':
    get:
      summary: Get account holder verification details
      operationId: get-account-holder-verification-details
      tags:
        - Account Holder Verification
      parameters:
        - $ref: '#/components/parameters/XVoltApiVersion'
        - name: id
          in: path
          description: The unique identifier of the account holder verification.
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Verification status and name-matching results.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountHolderVerificationDetails'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '415':
          $ref: '#/components/responses/415'
        '422':
          $ref: '#/components/responses/422'
        '500':
          $ref: '#/components/responses/500'
  '/account-holder-verifications/{id}/approve':
    post:
      summary: Approve account holder verification
      operationId: approve-account-holder-verification
      parameters:
        - $ref: '#/components/parameters/XVoltApiVersion'
        - $ref: '#/components/parameters/XVoltTestingScenario'
        - name: id
          in: path
          description: Identifier of the account holder verification.
          required: true
          schema:
            type: string
            format: uuid
      tags:
        - Account Holder Verification
      responses:
        '202':
          description: Accepted approval of account holder verification with the matching ID.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '409':
          $ref: '#/components/responses/409'
        '415':
          $ref: '#/components/responses/415'
        '422':
          $ref: '#/components/responses/422'
        '500':
          $ref: '#/components/responses/500'
  '/account-holder-verifications/{id}/reject':
    post:
      summary: Reject account holder verification
      operationId: reject-account-holder-verification
      parameters:
        - $ref: '#/components/parameters/XVoltApiVersion'
        - name: id
          in: path
          description: Identifier of the account holder verification.
          required: true
          schema:
            type: string
            format: uuid
      tags:
        - Account Holder Verification
      responses:
        '202':
          description: Accepted rejection request of account holder verification with the matching ID.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '409':
          $ref: '#/components/responses/409'
        '415':
          $ref: '#/components/responses/415'
        '422':
          $ref: '#/components/responses/422'
        '500':
          $ref: '#/components/responses/500'
  #
  # Operations related to Accounts
  #
  /accounts:
    get:
      summary: List of accounts
      operationId: get-accounts
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/XVoltApiVersion'
        - $ref: '#/components/parameters/LimitParam'
        - $ref: '#/components/parameters/PageParam'
        - in: query
          name: 'currency[]'
          schema:
            type: array
            description: Filter by Currency.
            items:
              $ref: '#/components/schemas/CurrencyCode'
            example:
              - EUR
        - in: query
          name: active
          description: Filter by Active.
          schema:
            type: boolean
      responses:
        '200':
          description: Retrieve accounts list.
          headers:
            limit:
              $ref: '#/components/headers/PaginationLimit'
            page:
              $ref: '#/components/headers/PaginationPage'
            page-count:
              $ref: '#/components/headers/PaginationPageCount'
            total-items:
              $ref: '#/components/headers/PaginationTotalItems'
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AccountMinimalDetails'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '415':
          $ref: '#/components/responses/415'
        '422':
          $ref: '#/components/responses/422'
        '500':
          $ref: '#/components/responses/500'
  '/accounts/{accountId}':
    get:
      tags:
        - Accounts
      summary: Get account details
      operationId: get-account-details
      parameters:
        - $ref: '#/components/parameters/XVoltApiVersion'
        - name: accountId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique identifier of the account.
      responses:
        '200':
          description: Successful account details response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountDetails'
              example:
                id: 7523a8d3-70a9-4448-822a-ba1a38e0b715
                currency: EUR
                identifications:
                  - iban: DE33500105173822933531
                    bic: ALBPPLPW
                name: My EUR account
                active: true
                country: DK
                balance:
                  available: 123
                  timestamp: '2023-10-16T16:52:37+00:00'
                type: VOLT_ACCOUNT
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '415':
          $ref: '#/components/responses/415'
        '422':
          $ref: '#/components/responses/422'
        '500':
          $ref: '#/components/responses/500'
  '/accounts/{accountId}/close':
    post:
      tags:
        - Accounts
      summary: Close account
      operationId: close-account
      description: Immediately closes the specified account. A closed account cannot be reopened or used for further transactions. Only Named Accounts can be closed.
      parameters:
        - $ref: '#/components/parameters/IdempotencyKey'
        - $ref: '#/components/parameters/XVoltApiVersion'
        - name: accountId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique identifier of the account to be closed.
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountCloseRequest'
      responses:
        '200':
          description: Account successfully closed.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '409':
          $ref: '#/components/responses/409'
        '415':
          $ref: '#/components/responses/415'
        '422':
          $ref: '#/components/responses/422'
        '500':
          $ref: '#/components/responses/500'
  '/accounts/{accountId}/beneficiaries':
    get:
      summary: List of transaction beneficiaries
      operationId: get-account-beneficiaries
      tags:
        - Accounts
      parameters:
        - $ref: '#/components/parameters/XVoltApiVersion'
        - $ref: '#/components/parameters/LimitParam'
        - $ref: '#/components/parameters/PageParam'
        - name: accountId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique identifier of the account
        - in: query
          name: iban
          schema:
            type: string
            example: DE07500105176551562526
            description: Filter by IBAN.
        - in: query
          name: sortCode
          schema:
            type: string
            example: 12345678
          description: Filter by SortCode number.
        - in: query
          name: accountNumber
          schema:
            type: string
            example: 12345678
          description: Filter by Account number.
        - in: query
          name: 'order[createdAt]'
          description: Sort order by createdAt field.
          schema:
            allOf:
              - $ref: '#/components/schemas/SortOrder'
            default: desc
      responses:
        '200':
          description: List of account beneficiaries
          headers:
            limit:
              $ref: '#/components/headers/PaginationLimit'
            page:
              $ref: '#/components/headers/PaginationPage'
            page-count:
              $ref: '#/components/headers/PaginationPageCount'
            total-items:
              $ref: '#/components/headers/PaginationTotalItems'
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AccountBeneficiaryMinimalDetails'
              example:
                - name: John Doe
                  accountIdentifiers:
                    iban: DE07500105176551562526
                    swiftBic: '123456'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '415':
          $ref: '#/components/responses/415'
        '422':
          $ref: '#/components/responses/422'
        '500':
          $ref: '#/components/responses/500'
  #
  # Operations related to Aliases
  #
  '/accounts/{accountId}/aliases':
    get:
      tags:
        - Aliases
      summary: List of aliases for an account
      operationId: get-aliases
      parameters:
        - $ref: '#/components/parameters/XVoltApiVersion'
        - $ref: '#/components/parameters/LimitParam'
        - $ref: '#/components/parameters/PageParam'
        - name: accountId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique identifier of the account
        - name: orderId
          in: query
          description: Filter aliases by the order id they were created with.
          required: false
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: List of aliases for the account
          headers:
            limit:
              $ref: '#/components/headers/PaginationLimit'
            page:
              $ref: '#/components/headers/PaginationPage'
            page-count:
              $ref: '#/components/headers/PaginationPageCount'
            total-items:
              $ref: '#/components/headers/PaginationTotalItems'
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AliasMinimalDetails'
              example:
                - id: 06949674-d65c-4266-a2c6-23bce4a80a81
                  currency: EUR
                  identifications:
                    - iban: DE33500105173822933531
                      bic: ALBPPLPW
                  name: Virtual account
                  customerId: dab4dd0c-d63b-439c-9c47-722ce7a01b60
                  accountId: ca52ea87-a0e3-4371-b301-63309d2e0aa3
                  active: true
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '415':
          $ref: '#/components/responses/415'
        '422':
          $ref: '#/components/responses/422'
        '500':
          $ref: '#/components/responses/500'
  /orders/account-aliases:
    post:
      tags:
        - Aliases
      operationId: order-aliases
      summary: Order aliases
      parameters:
        - $ref: '#/components/parameters/IdempotencyKey'
        - $ref: '#/components/parameters/XVoltApiVersion'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AliasesOrderRequest'
      responses:
        '201':
          description: Order for issuing account aliases created successfully.
          headers:
            Location:
              schema:
                type: string
                format: uri
              description: Location of created aliases order.
          content:
            application/json:
              schema:
                type: object
                description: Response containing the identifier of the created aliases order.
                properties:
                  id:
                    type: string
                    format: uuid
                    description: Unique ID of the aliases order.
                    example: 57ad1a6b-95ac-4b33-8c92-311cda8f3c99
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '409':
          $ref: '#/components/responses/409'
        '415':
          $ref: '#/components/responses/415'
        '422':
          $ref: '#/components/responses/422'
        '500':
          $ref: '#/components/responses/500'
  '/orders/account-aliases/{id}':
    get:
      tags:
        - Aliases
      operationId: get-alias-order-status
      summary: Get alias order status
      parameters:
        - $ref: '#/components/parameters/XVoltApiVersion'
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique identifier of the alias order
      responses:
        '200':
          description: Alias order details retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AliasOrderDetails'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '500':
          $ref: '#/components/responses/500'
  '/account-aliases/{aliasId}':
    get:
      tags:
        - Aliases
      summary: Get alias details
      operationId: get-alias-details
      parameters:
        - $ref: '#/components/parameters/XVoltApiVersion'
        - name: aliasId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique identifier of the alias
      responses:
        '200':
          description: Details of alias
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AliasDetails'
              example:
                id: 06949674-d65c-4266-a2c6-23bce4a80a81
                currency: EUR
                identifications:
                  - iban: DE33500105173822933531
                    bic: ALBPPLPW
                name: Virtual account
                customerId: dab4dd0c-d63b-439c-9c47-722ce7a01b60
                accountId: ca52ea87-a0e3-4371-b301-63309d2e0aa3
                orderId: 22cb500c-fe26-47ec-bd62-2023d674a8e3
                active: true
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '415':
          $ref: '#/components/responses/415'
        '422':
          $ref: '#/components/responses/422'
        '500':
          $ref: '#/components/responses/500'
    patch:
      tags:
        - Aliases
      summary: Change state of alias
      operationId: change-alias-state
      description: Marks the specified alias as active or inactive.
      parameters:
        - $ref: '#/components/parameters/IdempotencyKey'
        - $ref: '#/components/parameters/XVoltApiVersion'
        - name: aliasId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique identifier of the alias
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChangeAliasStateRequest'
      responses:
        '200':
          description: alias successfully updated
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '409':
          $ref: '#/components/responses/409'
        '415':
          $ref: '#/components/responses/415'
        '422':
          $ref: '#/components/responses/422'
        '500':
          $ref: '#/components/responses/500'
  '/account-aliases/{aliasId}/close':
    post:
      tags:
        - Aliases
      summary: Close alias
      operationId: close-alias
      description: Permanently closes the specified alias. A closed alias cannot be reopened or used for further transactions.
      parameters:
        - $ref: '#/components/parameters/IdempotencyKey'
        - $ref: '#/components/parameters/XVoltApiVersion'
        - name: aliasId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Unique identifier of the alias to be closed.
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AliasCloseRequest'
      responses:
        '200':
          description: Alias successfully closed.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '409':
          $ref: '#/components/responses/409'
        '415':
          $ref: '#/components/responses/415'
        '422':
          $ref: '#/components/responses/422'
        '500':
          $ref: '#/components/responses/500'
  #
  # Operations related to Trusted Accounts
  #
  /trusted-accounts:
    get:
      tags:
        - Trusted accounts
      summary: List of trusted accounts
      operationId: list-trusted-accounts
      parameters:
        - $ref: '#/components/parameters/XVoltApiVersion'
        - $ref: '#/components/parameters/LimitParam'
        - $ref: '#/components/parameters/PageParam'
        - name: active
          in: query
          required: false
          description: Find only active/inactive trusted accounts.
          schema:
            type: boolean
        - name: accountHolderEntityIds
          description: Find trusted accounts for specific account holder entity
          in: query
          required: false
          schema:
            type: array
       

# --- truncated at 32 KB (84 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/volt-io/refs/heads/main/openapi/volt-io-accounts-openapi-original.yaml