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

# Delete Trust Validation

> Permanently deletes all personal data held against a Trust Validation while retaining usage and billing records.

<Warning>
  This operation is irreversible. All personal data — including document scans, selfies, signatures, request payloads, and verification results — is permanently removed and cannot be recovered.
</Warning>

<Note>
  A `404` response is returned both when the `trustValidationId` does not exist and when it belongs to another company. Callers cannot use this response to probe for other companies' IDs.
</Note>


## OpenAPI

````yaml api-reference/openapi.json DELETE /api/v3/processes/delete-trust-validation
openapi: 3.0.3
info:
  title: IDmeta API
  description: IDmeta verification and integration API.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://{environment-subdomain}.idmetagroup.com
    description: Your environment (replace `{environment-subdomain}`)
    variables:
      environment-subdomain:
        default: integrate
        enum:
          - integrate
          - api.ph
        description: >-
          IDmeta environment subdomain. Use `api.ph` for
          portalph.idmetagroup.com and `integrate` for verify.idmetagroup.com.
security:
  - bearerAuth: []
tags:
  - name: Processes
    description: Verification process endpoints
  - name: Trust Flow Links
    description: Trust Flow link generation endpoints
  - name: Compliance
    description: Compliance verification endpoints
  - name: Government Data
    description: Government data verification endpoints
  - name: Alternative Verifications
    description: Alternative verification and intelligence endpoints
  - name: OCR
    description: Document OCR extraction endpoints
paths:
  /api/v3/processes/delete-trust-validation:
    delete:
      tags:
        - Processes
      summary: Delete Trust Validation
      description: >-
        Permanently deletes all personal data held against a Trust Validation.
        Every file stored for it (document scans, selfies, signatures) is
        removed from object storage, and the stored request payloads and results
        are wiped.


        The Trust Validation record itself is retained in a purged state so
        usage and billing history stay intact — its metadata and usage records
        are preserved. Personal data is not recoverable once deleted.


        The operation is idempotent: calling it again on an already-deleted
        Trust Validation returns 200.


        The API token's user must have the `delete_verification` permission.
      operationId: deleteTrustValidationV3
      parameters:
        - name: Accept
          in: header
          required: false
          schema:
            type: string
            default: application/json
        - name: Content-Type
          in: header
          required: false
          schema:
            type: string
            default: application/json
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteTrustValidationV3Request'
            examples:
              default:
                summary: Delete a trust validation
                value:
                  trustValidationId: '{your_trust_validation_id}'
      responses:
        '200':
          description: Trust validation deleted successfully, or already deleted
          headers:
            Content-Type:
              schema:
                type: string
                example: application/json
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteTrustValidationV3Response'
              example:
                success: true
                message: Trust Validation deleted successfully
                performedAt: '2026-08-20T08:41:00Z'
                createdAt: 2026-08-20 08:41:00+0000
        '400':
          description: trustValidationId missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V3ApiErrorResponse'
              example:
                success: false
                message: Invalid request
                errors:
                  trustValidationId:
                    - The trustValidationId field is required.
        '401':
          description: Missing or invalid token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V3ApiErrorResponse'
              example:
                success: false
                message: Unauthenticated.
                errors: {}
        '403':
          description: Token valid but the user lacks the delete_verification permission
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V3ApiErrorResponse'
              example:
                success: false
                message: Forbidden.
                errors: {}
        '404':
          description: Trust Validation not found, or it belongs to a different company
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V3ApiErrorResponse'
              example:
                success: false
                message: Trust Validation not found.
                errors: {}
        '500':
          description: Unexpected server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V3ApiErrorResponse'
              example:
                success: false
                message: An unexpected error occurred.
                errors: {}
components:
  schemas:
    DeleteTrustValidationV3Request:
      type: object
      required:
        - trustValidationId
      properties:
        trustValidationId:
          type: string
          maxLength: 255
          description: The ID returned by Create Trust Validation.
    DeleteTrustValidationV3Response:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        performedAt:
          type: string
          format: date-time
          description: ISO 8601 UTC timestamp of when the deletion ran.
        createdAt:
          type: string
          description: Standard v3 response timestamp present on all v3 endpoints.
    V3ApiErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
        errors:
          type: object
          additionalProperties: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Use `Bearer {your_api_token}` in the Authorization header.

````