---
updatedAt: 2026-03-25T11:20:20.000Z
---

# Get loans list

Returns loans list of all accessible loans relative to a granted consent

# 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/loans": {
      "get": {
        "summary": "Get loans list",
        "description": "Returns loans list of all accessible loans relative to a granted consent",
        "tags": [
          "Loans"
        ],
        "security": [
          {
            "BearerAuthOAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Request-ID"
          },
          {
            "$ref": "#/components/parameters/ConsentIdHeader"
          },
          {
            "$ref": "#/components/parameters/PSU-IP-Address"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LoansResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiProblemDetails"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "ConsentIdHeader": {
        "description": "ID of the corresponding consent object as returned by an account information consent request.\n",
        "name": "consentId",
        "in": "header",
        "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"
        }
      },
      "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"
        }
      }
    },
    "schemas": {
      "LoansResponse": {
        "type": "object",
        "description": "Array of LoanDetails objects representing individual loan accounts.",
        "properties": {
          "accounts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LoanDetails"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "LoanDetails": {
        "type": "object",
        "properties": {
          "resourceId": {
            "type": "string",
            "description": "A unique identifier for the loan account, represented as a string.",
            "nullable": true
          },
          "currency": {
            "type": "string",
            "description": "Currency of the loan account, represented by a three-letter ISO currency code.",
            "nullable": true
          },
          "relatedDates": {
            "description": "Contains key dates relevant to the loan, such as the contract start and end dates.",
            "$ref": "#/components/schemas/LoanRelatedDates"
          },
          "balances": {
            "type": "array",
            "description": "Array of LoanBalance objects providing balance information for the loan, such as outstanding amounts and balance types.",
            "items": {
              "$ref": "#/components/schemas/LoanBalance"
            },
            "nullable": true
          },
          "status": {
            "description": "The current status of the loan (e.g., active, inactive), referenced as a Statuses object.",
            "$ref": "#/components/schemas/Statuses"
          },
          "interest": {
            "description": "The current status of the loan (e.g., active, inactive), referenced as a Statuses object.",
            "$ref": "#/components/schemas/LoanInterest"
          },
          "product": {
            "type": "string",
            "description": "Name or identifier of the loan product.",
            "nullable": true
          },
          "_links": {
            "description": "Links to additional resources, such as balances or transactions, provided in the LinksLoanResponse structure.",
            "$ref": "#/components/schemas/LinksLoanResponse"
          }
        },
        "additionalProperties": false
      },
      "LinksLoanResponse": {
        "type": "object",
        "properties": {
          "balances": {
            "description": "Hyperlink reference to the loan balance details, provided as a HrefTypeResponse object.",
            "$ref": "#/components/schemas/HrefTypeResponse"
          },
          "transactions": {
            "description": "Hyperlink reference to the loan balance details, provided as a HrefTypeResponse object.",
            "$ref": "#/components/schemas/HrefTypeResponse"
          }
        },
        "additionalProperties": false
      },
      "HrefTypeResponse": {
        "type": "object",
        "properties": {
          "href": {
            "type": "string",
            "description": "URL string linking to a specific resource.",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "LoanInterest": {
        "type": "object",
        "properties": {
          "rate": {
            "description": "Interest rate applied to the loan, represented as a LoanInterestRate object.",
            "$ref": "#/components/schemas/LoanIterestRate"
          }
        },
        "additionalProperties": false
      },
      "LoanIterestRate": {
        "type": "object",
        "properties": {
          "percentage": {
            "type": "number",
            "description": "The loan's interest rate expressed as a percentage, formatted as a double.",
            "format": "double"
          }
        },
        "additionalProperties": false
      },
      "LoanBalanceAmount": {
        "type": "object",
        "properties": {
          "currency": {
            "type": "string",
            "description": "Currency of the balance, represented by a three-letter ISO currency code.",
            "nullable": true
          },
          "amount": {
            "type": "number",
            "description": "Monetary amount of the balance, formatted as a double for precise representation.",
            "format": "double"
          }
        },
        "additionalProperties": false
      },
      "LoanBalance": {
        "type": "object",
        "properties": {
          "balanceAmount": {
            "description": "Detailed amount and currency information for the balance, represented by a LoanBalanceAmount object.",
            "$ref": "#/components/schemas/LoanBalanceAmount"
          },
          "balanceType": {
            "description": "Type of balance (e.g., available, current), referenced as a BalanceTypes object.",
            "$ref": "#/components/schemas/BalanceTypes"
          },
          "balanceSubTypeProprietary": {
            "type": "string",
            "description": "Proprietary sub-type for the balance, given as a string and can be null.",
            "nullable": true
          },
          "referenceDate": {
            "type": "string",
            "description": "Date associated with the balance, formatted in date-time format.",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "LoanRelatedDates": {
        "type": "object",
        "properties": {
          "contractStartDate": {
            "type": "string",
            "description": "Date and time when the loan contract began, formatted as date-time.",
            "format": "date-time"
          },
          "contractEndDate": {
            "type": "string",
            "description": "Date and time when the loan contract is scheduled to end, formatted as date-time.",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "BalanceTypes": {
        "enum": [
          "ClosingBooked",
          "OpeningBooked",
          "ForwardAvailable",
          "InterimBooked",
          "Information"
        ],
        "type": "string",
        "description": "<div class=\"enum-desc\"><p>Values:</p><ul><li><i>ClosingBooked</i></li><li><i>OpeningBooked</i></li><li><i>ForwardAvailable</i></li><li><i>InterimBooked</i></li><li><i>Information</i></li></ul></div>",
        "x-enumNames": [
          "ClosingBooked",
          "OpeningBooked",
          "ForwardAvailable",
          "InterimBooked",
          "Information"
        ]
      },
      "Statuses": {
        "enum": [
          "Enabled",
          "Deleted"
        ],
        "type": "string",
        "description": "<div class=\"enum-desc\"><p>Values:</p><ul><li><i>Enabled</i></li><li><i>Deleted</i></li></ul></div>",
        "x-enumNames": [
          "Enabled",
          "Deleted"
        ]
      },
      "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
  }
}
```