right logo image
right logo image
Log on

API Explorer

Log off

v2.2.0 (143 APIs)

API Host: https://api.ttk.com.mk
Bank
Accounts
Views
Counterparties
Transactions

Create Bank

Create a new bank (Authenticated access).
Authentication is Mandatory

JSON request body fields:

JSON response body fields:

Typical Successful Response:

								
									
{
  "id":"gh.29.uk.x",
  "full_name":"uk",
  "short_name":"uk",
  "logo_url":"https://static.openbankproject.com/images/sandbox/bank_x.png",
  "website_url":"https://www.example.com",
  "swift_bic":"IIIGGB22",
  "national_identifier":"UK97ZZZ1234567890",
  "bank_routing":{
    "scheme":"BIC",
    "address":"OKOYFIHH"
  }
}
Required Roles:
  • CanCreateBank - Please login to request this Role
Possible Errors:
  • OBP-10001: Incorrect json format.
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-30210: Insufficient authorisation to Create Bank. You do not have the role CanCreateBank.
  • OBP-50000: Unknown Error.
  • OBP-20006: User is missing one or more roles:
Connector Methods:
Implemented in OBPv2.2.0 by createBank, operation_id: OBPv2.2.0-createBank

Create Transaction Type at bank

Create Transaction Types for the bank specified by BANK_ID:

  • id : Unique transaction type id across the API instance. SHOULD be a UUID. MUST be unique.
  • bank_id : The bank that supports this TransactionType
  • short_code : A short code (SHOULD have no-spaces) which MUST be unique across the bank. May be stored with Transactions to link here
  • summary : A succinct summary
  • description : A longer description
  • charge : The charge to the customer for each one of these

Authentication is Mandatory

URL Parameters:

JSON response body fields:

Typical Successful Response:

								
									
{
  "id":{
    "value":"123"
  },
  "bankId":{
    "value":"gh.uk.9j"
  },
  "shortCode":"80080",
  "summary":"SANDBOX_TAN",
  "description":"This is the sandbox mode, charging litter money.",
  "charge":{
    "currency":"EUR",
    "amount":"100"
  }
}
Required Roles:
  • CanCreateTransactionType - Please login to request this Role
Possible Errors:
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
  • OBP-10001: Incorrect json format.
  • OBP-40005: Insufficient authorisation to Create Transaction Type offered by the bank. The Request could not be created because you don't have access to CanCreateTransactionType.
  • OBP-50000: Unknown Error.
  • OBP-20006: User is missing one or more roles:
Connector Methods:
Implemented in OBPv2.1.0 by createTransactionType, operation_id: OBPv2.1.0-createTransactionType

Get Bank

Get the bank specified by BANK_ID
Returns information about a single bank specified by BANK_ID including:

  • Short and full name of bank
  • Logo URL
  • Website

Authentication is Mandatory

URL Parameters:

JSON response body fields:

Typical Successful Response:

								
									
{
  "id":"gh.29.uk",
  "short_name":"short_name ",
  "full_name":"full_name",
  "logo":"logo",
  "website":"www.openbankproject.com",
  "bank_routing":{
    "scheme":"Bank_ID",
    "address":"gh.29.uk"
  }
}
Possible Errors:
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-50000: Unknown Error.
  • OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
Connector Methods:
Implemented in OBPv1.2.1 by bankById, operation_id: OBPv1.2.1-bankById

Get Bank ATMS

Returns information about ATMs for a single bank specified by BANK_ID including:

  • Address
  • Geo Location
  • License the data under this endpoint is released under

Possible custom url parameters for pagination:

  • limit=NUMBER ==> default value: 50
  • offset=NUMBER ==> default value: 0

eg1:?limit=100&offset=0

  • sort_direction=ASC/DESC ==> default value: DESC.

eg2:?limit=100&offset=0&sort_direction=ASC

Authentication is Optional

URL Parameters:

JSON response body fields:

Typical Successful Response:

								
									
{
  "atms":[{
    "id":"5995d6a2-01b3-423c-a173-5481df49bdaf",
    "name":"String",
    "address":{
      "line_1":"Osloer Straße 16/17",
      "line_2":"Wedding",
      "line_3":"",
      "city":"Berlin",
      "state":"Berlin Brandenburg",
      "postcode":"13359",
      "country":"DE"
    },
    "location":{
      "latitude":11.45,
      "longitude":11.45
    },
    "meta":{
      "license":{
        "id":"5",
        "name":"TESOBE"
      }
    }
  }]
}
Possible Errors:
  • OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
  • No ATMs available. License may not be set.
  • OBP-50000: Unknown Error.
Connector Methods:
Implemented in OBPv1.4.0 by getAtms, operation_id: OBPv1.4.0-getAtms

Get Banks

Get banks on this API instance
Returns a list of banks supported on this server:

  • ID used as parameter in URLs
  • Short and full name of bank
  • Logo URL
  • Website

Authentication is Optional

JSON response body fields:

Typical Successful Response:

								
									
{
  "banks":[{
    "id":"gh.29.uk",
    "short_name":"short_name ",
    "full_name":"full_name",
    "logo":"logo",
    "website":"www.openbankproject.com",
    "bank_routing":{
      "scheme":"Bank_ID",
      "address":"gh.29.uk"
    }
  }]
}
Possible Errors:
  • OBP-50000: Unknown Error.
Connector Methods:
Implemented in OBPv1.2.1 by getBanks, operation_id: OBPv1.2.1-getBanks

Get Transaction Types at Bank

Get Transaction Types for the bank specified by BANK_ID:

Lists the possible Transaction Types available at the bank (as opposed to Transaction Request Types which are the possible ways Transactions can be created by this API Server).

  • id : Unique transaction type id across the API instance. SHOULD be a UUID. MUST be unique.
  • bank_id : The bank that supports this TransactionType
  • short_code : A short code (SHOULD have no-spaces) which MUST be unique across the bank. May be stored with Transactions to link here
  • summary : A succinct summary
  • description : A longer description
  • charge : The charge to the customer for each one of these

Authentication is Optional

URL Parameters:

JSON response body fields:

Typical Successful Response:

								
									
{
  "transaction_types":[{
    "id":{
      "value":"123"
    },
    "bank_id":"gh.29.uk",
    "short_code":"PlaceholderString",
    "summary":"PlaceholderString",
    "description":"PlaceholderString",
    "charge":{
      "currency":"EUR",
      "amount":"0"
    }
  }]
}
Possible Errors:
  • OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
  • OBP-50000: Unknown Error.
Connector Methods:
Implemented in OBPv2.0.0 by getTransactionTypes, operation_id: OBPv2.0.0-getTransactionTypes