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

# Delete a virtual account application

> Delete a user's onboarding application so onboarding can be re-tested in the sandbox.

<Warning>
  **Sandbox only.** This endpoint is available exclusively in the sandbox environment to support testing. It is not possible to delete a virtual account application in production.
</Warning>

Use this in the sandbox to reset a user's onboarding so it can be re-tested. After the application is deleted, the user can submit a new one and go through onboarding again.


## OpenAPI

````yaml products/retail-va/api-reference/retail-rtd.json DELETE /v1/remittances/users/{userId}/virtual-account-applications/{virtualAccountApplicationId}
openapi: 3.1.0
info:
  title: User Interface API
  description: >-
    API endpoints that are secured with JWT for purposes of calling Meridian
    APIs from a custom user interface.
  version: 1.0.0
servers:
  - url: https://remittances.sandbox.api-us.meridianapps.dev:80
    description: sandbox
security: []
tags: []
externalDocs:
  url: /
paths:
  /v1/remittances/users/{userId}/virtual-account-applications/{virtualAccountApplicationId}:
    delete:
      tags:
        - Onboarding
      summary: Delete a Virtual Account Application
      description: >-
        Deletes a user's virtual account onboarding application so onboarding
        can be re-tested. Once the application is deleted, the user can submit a
        new one and go through onboarding again.


        **Sandbox only.** This endpoint is available exclusively in the sandbox
        environment to support testing. Deleting a virtual account application
        is not possible in production.
      parameters:
        - name: userId
          in: path
          required: true
          description: ID of the user the application belongs to
          schema:
            type: string
        - name: virtualAccountApplicationId
          in: path
          required: true
          description: ID of the virtual account application (onboarding) to delete
          schema:
            type: string
        - $ref: '#/components/parameters/MeridianApiKeyHeader'
        - $ref: '#/components/parameters/MeridianTimestampHeader'
        - $ref: '#/components/parameters/MeridianSignatureHeader'
      responses:
        '204':
          description: Virtual account application deleted successfully
          headers: {}
        '401':
          description: Invalid authentication token
          headers: {}
        '404':
          description: No virtual account application found
          headers: {}
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/com.meridianpay.core.common.api.MeridianError
        '422':
          description: Failed to delete the virtual account application
          headers: {}
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/com.meridianpay.core.common.api.MeridianError
        '500':
          description: An internal error occurred
          headers: {}
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/com.meridianpay.core.common.api.MeridianError
      deprecated: false
components:
  parameters:
    MeridianApiKeyHeader:
      name: X-Meridian-Api-Key
      in: header
      required: true
      description: >-
        API key issued by Meridian during provisioning. See
        [Authentication](/products/retail-va/authentication).
      schema:
        type: string
      example: your-api-key
    MeridianTimestampHeader:
      name: X-Meridian-Timestamp
      in: header
      required: true
      description: >-
        Current time in milliseconds since the Unix epoch. Must be within 60
        seconds of the request. See
        [Authentication](/products/retail-va/authentication).
      schema:
        type: string
      example: '1749566400000'
    MeridianSignatureHeader:
      name: X-Meridian-Signature
      in: header
      required: true
      description: >-
        HMAC SHA-256 signature of the canonical request string, computed per
        request. See [Authentication](/products/retail-va/authentication) for
        how to construct it.
      schema:
        type: string
      example: <hmac-sha256-signature>
  schemas:
    com.meridianpay.core.common.api.MeridianError:
      type: object
      description: >-
        Standard error response returned when a request cannot be completed.
        Includes a human-readable message and, for validation failures, a list
        of field-level errors.
      properties:
        errorCode:
          type:
            - 'null'
            - string
          description: Machine-readable error code identifying the failure, when available
          title: String
        hasValidationErrors:
          type: boolean
          description: Whether the error includes one or more field-level validation errors
          title: Boolean
        message:
          type: string
          description: Human-readable description of the error
          title: String
        validationErrors:
          type: array
          description: >-
            List of field-level validation errors, empty when the failure is not
            validation-related
          items:
            $ref: >-
              #/components/schemas/com.meridianpay.core.common.api.ValidationError
          title: Array_ValidationError
      required:
        - hasValidationErrors
        - message
        - validationErrors
      title: MeridianError
    com.meridianpay.core.common.api.ValidationError:
      description: >-
        A single validation error describing why a specific field or parameter
        was rejected. Resolves to one of the validation error types below.
      anyOf:
        - $ref: >-
            #/components/schemas/com.meridianpay.core.common.api.ValidationError.InvalidFormat
        - $ref: >-
            #/components/schemas/com.meridianpay.core.common.api.ValidationError.InvalidValue
        - $ref: >-
            #/components/schemas/com.meridianpay.core.common.api.ValidationError.MissingPathParameter
        - $ref: >-
            #/components/schemas/com.meridianpay.core.common.api.ValidationError.MissingQueryParameter
        - $ref: >-
            #/components/schemas/com.meridianpay.core.common.api.ValidationError.MissingRequestBody
        - $ref: >-
            #/components/schemas/com.meridianpay.core.common.api.ValidationError.MissingValue
        - $ref: >-
            #/components/schemas/com.meridianpay.core.common.api.ValidationError.NotFound
        - $ref: >-
            #/components/schemas/com.meridianpay.core.common.api.ValidationError.UnexpectedVerificationError
        - $ref: >-
            #/components/schemas/com.meridianpay.core.common.api.ValidationError.UnprocessableValue
      title: ValidationError
    com.meridianpay.core.common.api.ValidationError.InvalidFormat:
      type: object
      description: >-
        A field was provided in a format the API could not accept, such as a
        malformed date, identifier, or currency code.
      properties:
        fieldRef:
          type: string
          description: Reference to the request field that caused the validation error
          title: String
        message:
          type: string
          description: Human-readable explanation of why the field failed validation
          title: String
      required:
        - fieldRef
        - message
      title: InvalidFormat
    com.meridianpay.core.common.api.ValidationError.InvalidValue:
      type: object
      description: >-
        A field was well-formed but its value failed validation, such as an
        amount that is not positive or a currency code of the wrong length.
      properties:
        fieldRef:
          type: string
          description: Reference to the request field that caused the validation error
          title: String
        message:
          type: string
          description: Human-readable explanation of why the field failed validation
          title: String
      required:
        - fieldRef
        - message
      title: InvalidValue
    com.meridianpay.core.common.api.ValidationError.MissingPathParameter:
      type: object
      description: >-
        A required path parameter was missing from the request URL, such as the
        user or account identifier.
      properties:
        fieldRef:
          type: string
          description: Reference to the request field that caused the validation error
          title: String
        message:
          type: string
          description: Human-readable explanation of why the field failed validation
          title: String
      required:
        - fieldRef
        - message
      title: MissingPathParameter
    com.meridianpay.core.common.api.ValidationError.MissingQueryParameter:
      type: object
      description: A required query parameter was missing from the request.
      properties:
        fieldRef:
          type: string
          description: Reference to the request field that caused the validation error
          title: String
        message:
          type: string
          description: Human-readable explanation of why the field failed validation
          title: String
      required:
        - fieldRef
        - message
      title: MissingQueryParameter
    com.meridianpay.core.common.api.ValidationError.MissingRequestBody:
      type: object
      description: The request body was required but was not provided.
      properties:
        fieldRef:
          type: string
          description: Reference to the request field that caused the validation error
          title: String
        message:
          type: string
          description: Human-readable explanation of why the field failed validation
          title: String
      required:
        - fieldRef
        - message
      title: MissingRequestBody
    com.meridianpay.core.common.api.ValidationError.MissingValue:
      type: object
      description: A required field was missing from the request body.
      properties:
        fieldRef:
          type: string
          description: Reference to the request field that caused the validation error
          title: String
        message:
          type: string
          description: Human-readable explanation of why the field failed validation
          title: String
      required:
        - fieldRef
        - message
      title: MissingValue
    com.meridianpay.core.common.api.ValidationError.NotFound:
      type: object
      description: >-
        A resource referenced by the request could not be found, such as an
        unknown quote or virtual account.
      properties:
        fieldRef:
          type: string
          description: Reference to the request field that caused the validation error
          title: String
        message:
          type: string
          description: Human-readable explanation of why the field failed validation
          title: String
      required:
        - fieldRef
        - message
      title: NotFound
    com.meridianpay.core.common.api.ValidationError.UnexpectedVerificationError:
      type: object
      description: An unexpected error occurred while verifying the request.
      properties:
        fieldRef:
          type: string
          description: Reference to the request field that caused the validation error
          title: String
        message:
          type: string
          description: Human-readable explanation of why the field failed validation
          title: String
      required:
        - fieldRef
        - message
      title: UnexpectedVerificationError
    com.meridianpay.core.common.api.ValidationError.UnprocessableValue:
      type: object
      description: >-
        A field value was well-formed but could not be processed in the current
        context, such as a quote that has expired.
      properties:
        fieldRef:
          type: string
          description: Reference to the request field that caused the validation error
          title: String
        message:
          type: string
          description: Human-readable explanation of why the field failed validation
          title: String
      required:
        - fieldRef
        - message
      title: UnprocessableValue

````