---
updatedAt: 2026-03-25T11:18:57.000Z
---

# Delete Consent

The TPP can delete an account information consent object if needed.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "OpenBanking Services - Account Information Service (AIS)",
    "description": "The Account Information Service (AIS) offers the following services:\n  * Transaction reports for a given account or card account including balances if applicable\n  * Balances of a given account or card account\n  * A list of available accounts or card account\n  * Account details of a given account or card account or of the list of all accessible accounts or card account relative to a granted consent \n\nAbbreviations used in the documentation:\n  * TPP - Third Party Providers\n  * AIS - Account Information Service\n  * ASPSP - Account Servicing Payment Service Provider \n  * PSU - Payment Service User\n  * SCA - Strong Customer Authentication\n",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://test-openbanking.tbcbank.ge/0.8",
      "description": "Sandbox"
    },
    {
      "url": "https://openbanking.tbcbank.ge/0.8",
      "description": "Production"
    },
    {
      "url": "https://test-api.tbcbank.ge",
      "description": "Sandbox for .well-known and authorize endpoints"
    },
    {
      "url": "https://api.tbcbank.ge",
      "description": "Production for .well-known and authorize endpoints"
    }
  ],
  "paths": {
    "/v1/consents/{consentId}": {
      "delete": {
        "summary": "Delete Consent",
        "description": "The TPP can delete an account information consent object if needed.",
        "operationId": "aisdeleteconsent",
        "tags": [
          "Consents"
        ],
        "security": [
          {
            "BearerAuthOAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/ConsentId"
          },
          {
            "$ref": "#/components/parameters/X-Request-ID"
          },
          {
            "$ref": "#/components/parameters/Digest"
          },
          {
            "$ref": "#/components/parameters/X-JWS-Signature"
          },
          {
            "$ref": "#/components/parameters/PSU-IP-Address"
          },
          {
            "$ref": "#/components/parameters/Accept-Language"
          },
          {
            "$ref": "#/components/parameters/PSU-IP-Port"
          },
          {
            "$ref": "#/components/parameters/PSU-Geo-Location"
          }
        ],
        "responses": {
          "204": {
            "description": "No Content",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/X-Request-ID"
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/X-Request-ID"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                },
                "example": {
                  "$ref": "#/components/examples/400_BadRequest_Example_Consents"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/X-Request-ID"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                },
                "example": {
                  "$ref": "#/components/examples/401_Unauthorized_Example_Consents"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/X-Request-ID"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                },
                "example": {
                  "$ref": "#/components/examples/403_Forbidden_Example_Consents"
                }
              }
            }
          },
          "404": {
            "description": "NotFound",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/X-Request-ID"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                },
                "example": {
                  "$ref": "#/components/examples/404_NotFound_Example_Consents"
                }
              }
            }
          },
          "500": {
            "description": "Server Error",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/X-Request-ID"
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                },
                "example": {
                  "$ref": "#/components/examples/500_InternalError_Example_Consents"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "headers": {
      "X-Request-ID": {
        "description": "ID of the request, unique to the call, as determined by the initiating party.",
        "required": true,
        "example": "dca140c0-7db3-4cf3-9415-81b5a141f5f3",
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      }
    },
    "parameters": {
      "ConsentId": {
        "description": "ID of the corresponding consent object as returned by an account information consent request.\n",
        "name": "consentId",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "X-Request-ID": {
        "name": "X-Request-ID",
        "in": "header",
        "description": "ID of the request, unique to the call, as determined by the initiating party.",
        "required": true,
        "example": "dca140c0-7db3-4cf3-9415-81b5a141f5f3",
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      "Digest": {
        "name": "Digest",
        "in": "header",
        "description": "Is contained if and only if the \"Signature\" element is contained in the header of the request.",
        "required": true,
        "example": "SHA-256=+cHUU0wsuM/h13R5ler2wULmkj+gN3XAuUww3SbbAdM=",
        "schema": {
          "type": "string"
        }
      },
      "X-JWS-Signature": {
        "name": "X-JWS-Signature",
        "in": "header",
        "description": "A signature of the request by the TPP on application level. This might be mandated by ASPSP.",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "PSU-IP-Address": {
        "name": "PSU-IP-Address",
        "in": "header",
        "description": "The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP. It shall be contained if and only if this request was actively initiated by the PSU.",
        "required": true,
        "example": "123.345.567.78",
        "schema": {
          "type": "string",
          "format": "ipv4 or ipv6"
        }
      },
      "Accept-Language": {
        "name": "Accept-Language",
        "in": "header",
        "description": "HTTP header indicates the natural language and locale that the client prefers.",
        "example": "ka",
        "schema": {
          "type": "string"
        }
      },
      "PSU-IP-Port": {
        "name": "PSU-IP-Port",
        "in": "header",
        "description": "The forwarded IP Port header field consists of the corresponding HTTP request IP Port field between PSU and TPP, if available.",
        "example": "1234",
        "schema": {
          "type": "string"
        }
      },
      "PSU-Geo-Location": {
        "name": "PSU-Geo-Location",
        "in": "header",
        "description": "The forwarded Geo Location of the corresponding http request between PSU and TPP if available.",
        "example": "GEO:42.00;43.50",
        "schema": {
          "type": "string"
        }
      }
    },
    "schemas": {
      "ApiProblemDetails": {
        "description": "A machine-readable format for specifying errors in HTTP API responses.",
        "type": "object",
        "properties": {
          "type": {
            "description": "A URI reference [RFC3986] that identifies the problem type.",
            "type": "string"
          },
          "title": {
            "description": "A short, human-readable summary of the problem type.",
            "type": "string"
          },
          "status": {
            "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
            "type": "integer",
            "format": "int32"
          },
          "detail": {
            "description": "A human-readable explanation specific to this occurrence of the problem.",
            "type": "string"
          },
          "instance": {
            "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced.",
            "type": "string"
          },
          "traceId": {
            "description": "Message identification for searching errors",
            "type": "string"
          },
          "code": {
            "type": "string",
            "description": "Message codes defined for AIS for appropriate HTTP status code"
          }
        }
      }
    },
    "examples": {
      "400_BadRequest_Example_Consents": {
        "value": {
          "code": "FORMAT_ERROR",
          "traceId": "00-5336c4b7d89889b8b4a1bbdfb8c1a583-305db5d2099f1c58-01",
          "type": "https://developers.tbcbank.ge/docs/error-type-400",
          "title": "Invalid Request",
          "status": 400,
          "detail": "ValidUntil parameter is invalid, please check the date.",
          "instance": "/v1/consents"
        }
      },
      "401_Unauthorized_Example_Consents": {
        "value": {
          "type": "https://developers.tbcbank.ge/docs/error-type-401",
          "title": "Access Token is expired.",
          "status": 401,
          "detail": "Access Token is expired.",
          "systemCode": "System code for problem is System code for problem is psd2_accounts-0.8.401.TOKEN_EXPIRED",
          "code": "TOKEN_EXPIRED",
          "traceId": "rrt-04053ba3aa8013db2-a-de-14879-4916302-1",
          "instance": "/v1/consents/c9161b2e-46d0-4891-8114-2767253d4510"
        }
      },
      "403_Forbidden_Example_Consents": {
        "value": {
          "code": "CONSENT_UNKNOWN",
          "traceId": "00-88e0f2509e1d5ad73d99dee283010f18-bdcf39859de601a7-01",
          "type": "https://developers.tbcbank.ge/docs/error-type-403",
          "title": "Consent not found",
          "status": 403,
          "detail": "Consent not found with this Id: c9161b2e-46d0-4891-8114-2767253d4510",
          "instance": "/v1/consents/c9161b2e-46d0-4891-8114-2767253d4510"
        }
      },
      "404_NotFound_Example_Consents": {
        "value": {
          "traceId": "00-88e0f2509e1d5ad73d99dee283010f18-bdcf39859de601a7-01",
          "type": "https://developers.tbcbank.ge/docs/error-type-404",
          "title": "Consent not found",
          "status": 404,
          "instance": "/v1/consents/c9161b2e-46d0-4891-8114-2767253d4510"
        }
      },
      "500_InternalError_Example_Consents": {
        "value": {
          "code": "",
          "traceId": "00-ada2ec0e2c26c91bf50469bf79fdb14e-7bed7bf0dd005c16-01",
          "type": "https://developers.tbcbank.ge/docs/error-type-500",
          "title": "Internal Error",
          "status": 500,
          "detail": "Something wrong happened in the application",
          "instance": "/v1/consents"
        }
      }
    }
  },
  "security": [
    {}
  ],
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```