--- updatedAt: 2026-03-25T11:20:13.000Z --- # Delete consent The TPP can delete an account information consent object if needed. # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "OpenBanking Service For Loans and Savings", "description": "APIs for getting user consent on subject such as Account Information Services (AIS), Client Information and etc.\n\nThe result of this process is a consent resource. A link to this resource is returned to the AISP within this process.\nThe TPP can retrieve the consent object by submitting a GET method on this resource.\nThis object contains the detailed access rights, the current validity and a Consent-ID token. \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\nIn order to make test integration, please use https://test-openbanking.tbcbank.ge\n", "version": "1.0" }, "servers": [ { "url": "https://test-api.tbcbank.ge/xs2a-sandbox" }, { "url": "https://test-openbanking.tbcbank.ge" }, { "url": "https://openbanking.tbcbank.ge" } ], "paths": { "/v2/consents/account-access/{consentId}": { "delete": { "summary": "Delete consent", "description": "The TPP can delete an account information consent object if needed.", "tags": [ "Consent" ], "security": [ { "BearerAuthOAuth": [] } ], "parameters": [ { "$ref": "#/components/parameters/ConsentId" }, { "$ref": "#/components/parameters/X-Request-ID" }, { "$ref": "#/components/parameters/Digest" }, { "$ref": "#/components/parameters/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": { "code": "FORMAT_ERROR", "traceId": "00-88e0f2509e1d5ad73d99dee283010f18-bdcf39859de601a7-01", "type": "https://developers.tbcbank.ge/docs/error-type-400", "title": "Invalid ConsentId", "status": 400, "detail": "ConsentId is not valid Guid: 123", "instance": "/v1/consents/123" } } } }, "401": { "description": "Unauthorized", "headers": { "X-Request-ID": { "$ref": "#/components/headers/X-Request-ID" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ApiProblemDetails" }, "example": { "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": { "description": "Forbidden", "headers": { "X-Request-ID": { "$ref": "#/components/headers/X-Request-ID" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ApiProblemDetails" }, "example": { "code": "CONSENT_UNKNOWN", "traceId": "00-88e0f2509e1d5ad73d99dee283010f18-bdcf39859de601a7-01", "type": "https://developers.tbcbank.ge/docs/error-type-400", "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": { "description": "NotFound", "headers": { "X-Request-ID": { "$ref": "#/components/headers/X-Request-ID" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ApiProblemDetails" }, "example": { "traceId": "00-88e0f2509e1d5ad73d99dee283010f18-bdcf39859de601a7-01", "type": "https://developers.tbcbank.ge/docs/error-type-400", "title": "Consent not found", "status": 404, "instance": "/v1/consents/c9161b2e-46d0-4891-8114-2767253d4510" } } } }, "500": { "description": "Server Error", "headers": { "X-Request-ID": { "$ref": "#/components/headers/X-Request-ID" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ApiProblemDetails" }, "example": { "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/c9161b2e-46d0-4891-8114-2767253d4510" } } } } } } } }, "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" } }, "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" } } } }, "securitySchemes": { "BearerAuthOAuth": { "description": "Bearer Token. \n\nIs contained only, if an OAuth2 based authentication was performed in a pre-step or \nan OAuth2 based SCA was performed in a preceding AIS service in the same session.\n", "type": "http", "scheme": "bearer" } } }, "security": [ {} ], "x-readme": { "explorer-enabled": true, "proxy-enabled": true } } ```