API Explorer
-
Customer
-
Create Tax Residence
-
Delete Customer Address
-
Delete Tax Residence
-
Get Customer Addresses
-
Get Customer by CUSTOMER_NUMBER
-
Get Customers by MOBILE_PHONE_NUMBER
-
Get Tax Residences of Customer
-
Create Tax Residence
-
Customer Meeting
-
KYC
-
Add KYC Check
-
Add KYC Document
-
Add KYC Media
-
Add KYC Status
-
Get Customer KYC Checks
-
Get Customer KYC Documents
-
Get Customer KYC statuses
-
Get KYC Media for a customer
-
Add KYC Check
v4.0.0 filtered by tag: KYC (18 APIs)
Create Tax Residence
Create a Tax Residence for a Customer specified by CUSTOMER_ID.
Authentication is Mandatory
URL Parameters:
-
BANK_ID: gh.29.uk
-
CUSTOMER_ID: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
JSON request body fields:
JSON response body fields:
{
"domain":"Enter some domain",
"tax_number":"Enter some number",
"tax_residence_id":"902ba3bb-dedd-45e7-9319-2fd3f2cd98a1"
}
-
CanCreateTaxResidence
- Please login to request this Role
- OBP-20001: User not logged in. Authentication is required!
- OBP-20006: User is missing one or more roles:
- OBP-10001: Incorrect json format.
- OBP-50000: Unknown Error.
Delete Customer Address
Delete an Address of the Customer specified by CUSTOMER_ADDRESS_ID.
Authentication is Mandatory
URL Parameters:
-
BANK_ID: gh.29.uk
-
CUSTOMER_ID: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
JSON response body fields:
{
"jsonString":"{}"
}
-
CanDeleteCustomerAddress
- Please login to request this Role
- OBP-20001: User not logged in. Authentication is required!
- OBP-20006: User is missing one or more roles:
- OBP-50000: Unknown Error.
Delete Tax Residence
Delete a Tax Residence of the Customer specified by TAX_RESIDENCE_ID.
Authentication is Mandatory
URL Parameters:
-
BANK_ID: gh.29.uk
-
CUSTOMER_ID: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
JSON response body fields:
{
"jsonString":"{}"
}
- OBP-20001: User not logged in. Authentication is required!
- OBP-50000: Unknown Error.
Get Customer Addresses
Get the Addresses of the Customer specified by CUSTOMER_ID.
Authentication is Mandatory
URL Parameters:
-
BANK_ID: gh.29.uk
-
CUSTOMER_ID: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
JSON response body fields:
-
customer_id: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
-
insert_date: 2020-01-27
{
"addresses":[{
"customer_address_id":"5995d6a2-01b3-423c-a173-5481df49bdaf",
"customer_id":"7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh",
"line_1":"No 1 the Road",
"line_2":"The Place",
"line_3":"The Hill",
"city":"Berlin",
"county":"",
"state":"Brandenburg",
"postcode":"13359",
"country_code":"DE",
"tags":["mailing","home"],
"status":"OK",
"insert_date":"2017-09-19T00:00:00Z"
}]
}
-
CanGetCustomerAddress
- Please login to request this Role
- OBP-20001: User not logged in. Authentication is required!
- OBP-20006: User is missing one or more roles:
- OBP-50000: Unknown Error.
Get Customer by CUSTOMER_NUMBER
Gets the Customer specified by CUSTOMER_NUMBER.
Authentication is Mandatory
URL Parameters:
- BANK_ID: gh.29.uk
JSON request body fields:
- customer_number: 5987953
JSON response body fields:
-
amount: 10.12
-
bank_id: gh.29.uk
-
branch_id: DERBY6
-
currency: EUR
-
customer_attribute_id: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
-
customer_id: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
-
customer_number: 5987953
-
date: 2020-01-27
-
date_of_birth: 2018-03-09
-
employment_status: worker
-
highest_education_attained: Master
-
kyc_status: true
-
legal_name: Eveline Tripman
-
name_suffix: Sr
-
relationship_status: single
-
title: Dr.
-
value: 5987953
{
"bank_id":"gh.29.uk",
"customer_id":"7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh",
"customer_number":"5987953",
"legal_name":"Eveline Tripman",
"mobile_phone_number":"+44 07972 444 876",
"email":"felixsmith@example.com",
"face_image":{
"url":"www.openbankproject",
"date":"2017-09-19T00:00:00Z"
},
"date_of_birth":"2017-09-19T00:00:00Z",
"relationship_status":"single",
"dependants":1,
"dob_of_dependants":["2017-09-19T00:00:00Z"],
"credit_rating":{
"rating":"OBP",
"source":"OBP"
},
"credit_limit":{
"currency":"EUR",
"amount":"0"
},
"highest_education_attained":"Master",
"employment_status":"worker",
"kyc_status":true,
"last_ok_date":"2017-09-19T00:00:00Z",
"title":"Dr.",
"branch_id":"DERBY6",
"name_suffix":"Sr",
"customer_attributes":[{
"customer_attribute_id":"7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh",
"name":"SPECIAL_TAX_NUMBER",
"type":"STRING",
"value":"123456789"
}]
}
-
CanGetCustomer
- Please login to request this Role
- OBP-20001: User not logged in. Authentication is required!
- OBP-30008: User Customer Link not found by USER_ID
- OBP-50000: Unknown Error.
- OBP-20006: User is missing one or more roles:
Get Customers by MOBILE_PHONE_NUMBER
Gets the Customers specified by MOBILE_PHONE_NUMBER.
There are two wildcards often used in conjunction with the LIKE operator:
% - The percent sign represents zero, one, or multiple characters
_ - The underscore represents a single character
For example {"customer_phone_number":"%381%"} lists all numbers which contain 381 sequence
Authentication is Mandatory
URL Parameters:
- BANK_ID: gh.29.uk
JSON request body fields:
JSON response body fields:
-
amount: 10.12
-
bank_id: gh.29.uk
-
branch_id: DERBY6
-
currency: EUR
-
customer_id: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
-
customer_number: 5987953
-
date: 2020-01-27
-
date_of_birth: 2018-03-09
-
employment_status: worker
-
highest_education_attained: Master
-
kyc_status: true
-
legal_name: Eveline Tripman
-
name_suffix: Sr
-
relationship_status: single
-
title: Dr.
{
"bank_id":"gh.29.uk",
"customer_id":"7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh",
"customer_number":"5987953",
"legal_name":"Eveline Tripman",
"mobile_phone_number":"+44 07972 444 876",
"email":"felixsmith@example.com",
"face_image":{
"url":"www.openbankproject",
"date":"2017-09-19T00:00:00Z"
},
"date_of_birth":"2017-09-19T00:00:00Z",
"relationship_status":"single",
"dependants":1,
"dob_of_dependants":["2017-09-19T00:00:00Z"],
"credit_rating":{
"rating":"OBP",
"source":"OBP"
},
"credit_limit":{
"currency":"EUR",
"amount":"0"
},
"highest_education_attained":"Master",
"employment_status":"worker",
"kyc_status":true,
"last_ok_date":"2017-09-19T00:00:00Z",
"title":"Dr.",
"branch_id":"DERBY6",
"name_suffix":"Sr"
}
- OBP-20001: User not logged in. Authentication is required!
- OBP-30008: User Customer Link not found by USER_ID
- OBP-50000: Unknown Error.
Get Tax Residences of Customer
Get the Tax Residences of the Customer specified by CUSTOMER_ID.
Authentication is Mandatory
URL Parameters:
-
BANK_ID: gh.29.uk
-
CUSTOMER_ID: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
JSON response body fields:
{
"tax_residence":[{
"domain":"Enter some domain",
"tax_number":"Enter some number",
"tax_residence_id":"902ba3bb-dedd-45e7-9319-2fd3f2cd98a1"
}]
}
- OBP-20001: User not logged in. Authentication is required!
- OBP-50000: Unknown Error.
Create Meeting (video conference/call)
Create Meeting: Initiate a video conference/call with the bank.
The Meetings resource contains meta data about video/other conference sessions
provider_id determines the provider of the meeting / video chat service. MUST be url friendly (no spaces).
purpose_id explains the purpose of the chat. onboarding | mortgage | complaint etc. MUST be url friendly (no spaces).
Login is required.
This call is experimental. Currently staff_user_id is not set. Further calls will be needed to correctly set this.
Authentication is Mandatory
URL Parameters:
- BANK_ID: gh.29.uk
JSON request body fields:
- date: 2020-01-27
JSON response body fields:
-
bank_id: gh.29.uk
-
session_id: b4e0352a-9a0f-4bfa-b30b-9003aa467f50
-
when: 2020-01-27
{
"meeting_id":"UUID-String",
"provider_id":"Chris",
"purpose_id":"String, eg: onboarding",
"bank_id":"gh.29.uk",
"present":{
"staff_user_id":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
"customer_user_id":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1"
},
"keys":{
"session_id":"String",
"staff_token":"String",
"customer_token":"String"
},
"when":"2017-09-19T00:00:00Z",
"creator":{
"name":"Simon ",
"mobile_phone":"+44 07972 444 876",
"email_address":"felixsmith@example.com"
},
"invitees":[{
"contact_details":{
"name":"Simon ",
"mobile_phone":"+44 07972 444 876",
"email_address":"felixsmith@example.com"
},
"status":"String, eg: Good"
}]
}
- 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-50000: Unknown Error.
Get Meeting
Get Meeting specified by BANK_ID / MEETING_ID
Meetings contain meta data about, and are used to facilitate, video conferences / chats etc.
The actual conference/chats are handled by external services.
Login is required.
This call is experimental and will require further authorisation in the future.
Authentication is Mandatory
URL Parameters:
- BANK_ID: gh.29.uk
JSON response body fields:
-
bank_id: gh.29.uk
-
session_id: b4e0352a-9a0f-4bfa-b30b-9003aa467f50
-
when: 2020-01-27
{
"meeting_id":"UUID-String",
"provider_id":"Chris",
"purpose_id":"String, eg: onboarding",
"bank_id":"gh.29.uk",
"present":{
"staff_user_id":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
"customer_user_id":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1"
},
"keys":{
"session_id":"String",
"staff_token":"String",
"customer_token":"String"
},
"when":"2017-09-19T00:00:00Z",
"creator":{
"name":"Simon ",
"mobile_phone":"+44 07972 444 876",
"email_address":"felixsmith@example.com"
},
"invitees":[{
"contact_details":{
"name":"Simon ",
"mobile_phone":"+44 07972 444 876",
"email_address":"felixsmith@example.com"
},
"status":"String, eg: Good"
}]
}
- OBP-20001: User not logged in. Authentication is required!
- OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
- OBP-30104: Meeting not found.
- OBP-50000: Unknown Error.
Get Meetings
Meetings contain meta data about, and are used to facilitate, video conferences / chats etc.
The actual conference/chats are handled by external services.
Login is required.
This call is experimental and will require further authorisation in the future.
Authentication is Mandatory
URL Parameters:
- BANK_ID: gh.29.uk
JSON response body fields:
-
bank_id: gh.29.uk
-
session_id: b4e0352a-9a0f-4bfa-b30b-9003aa467f50
-
when: 2020-01-27
{
"meetings":[{
"meeting_id":"UUID-String",
"provider_id":"Chris",
"purpose_id":"String, eg: onboarding",
"bank_id":"gh.29.uk",
"present":{
"staff_user_id":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
"customer_user_id":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1"
},
"keys":{
"session_id":"String",
"staff_token":"String",
"customer_token":"String"
},
"when":"2017-09-19T00:00:00Z",
"creator":{
"name":"Simon ",
"mobile_phone":"+44 07972 444 876",
"email_address":"felixsmith@example.com"
},
"invitees":[{
"contact_details":{
"name":"Simon ",
"mobile_phone":"+44 07972 444 876",
"email_address":"felixsmith@example.com"
},
"status":"String, eg: Good"
}]
}]
}
- OBP-20001: User not logged in. Authentication is required!
- OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
- OBP-50000: Unknown Error.
Add KYC Check
Add a KYC check for the customer specified by CUSTOMER_ID. KYC Checks store details of checks on a customer made by the KYC team, their comments and a satisfied status
Authentication is Mandatory
URL Parameters:
-
BANK_ID: gh.29.uk
-
CUSTOMER_ID: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
JSON response body fields:
-
bank_id: gh.29.uk
-
customer_id: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
-
customer_number: 5987953
-
date: 2020-01-27
-
satisfied: true
{
"bank_id":"gh.29.uk",
"customer_id":"7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh",
"id":"PlaceholderString",
"customer_number":"5987953",
"date":"2017-09-19T00:00:00Z",
"how":"PlaceholderString",
"staff_user_id":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
"staff_name":"PlaceholderString",
"satisfied":true,
"comments":"PlaceholderString"
}
-
CanAddKycCheck
- Please login to request this Role
- OBP-20001: User not logged in. Authentication is required!
- OBP-10001: Incorrect json format.
- OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
- OBP-30046: Customer not found. Please specify a valid value for CUSTOMER_ID.
- OBP-00004: Server error: could not add message
- OBP-50000: Unknown Error.
- OBP-20006: User is missing one or more roles:
Add KYC Document
Add a KYC document for the customer specified by CUSTOMER_ID. KYC Documents contain the document type (e.g. passport), place of issue, expiry etc.
Authentication is Mandatory
URL Parameters:
-
BANK_ID: gh.29.uk
-
CUSTOMER_ID: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
JSON response body fields:
-
bank_id: gh.29.uk
-
customer_id: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
-
customer_number: 5987953
-
expiry_date: 2021-01-27
-
issue_date: 2020-01-27
{
"bank_id":"gh.29.uk",
"customer_id":"7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh",
"id":"PlaceholderString",
"customer_number":"5987953",
"type":"PlaceholderString",
"number":"PlaceholderString",
"issue_date":"2017-09-19T00:00:00Z",
"issue_place":"PlaceholderString",
"expiry_date":"2017-09-19T00:00:00Z"
}
-
CanAddKycDocument
- Please login to request this Role
- OBP-20001: User not logged in. Authentication is required!
- OBP-10001: Incorrect json format.
- OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
- OBP-30046: Customer not found. Please specify a valid value for CUSTOMER_ID.
- Server error: could not add KycDocument
- OBP-50000: Unknown Error.
- OBP-20006: User is missing one or more roles:
Add KYC Media
Add some KYC media for the customer specified by CUSTOMER_ID. KYC Media resources relate to KYC Documents and KYC Checks and contain media urls for scans of passports, utility bills etc
Authentication is Mandatory
URL Parameters:
-
BANK_ID: gh.29.uk
-
CUSTOMER_ID: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
JSON response body fields:
-
bank_id: gh.29.uk
-
customer_id: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
-
customer_number: 5987953
-
date: 2020-01-27
{
"bank_id":"gh.29.uk",
"customer_id":"PlaceholderString",
"id":"PlaceholderString",
"customer_number":"5987953",
"type":"PlaceholderString",
"url":"PlaceholderString",
"date":"2017-09-19T00:00:00Z",
"relates_to_kyc_document_id":"PlaceholderString",
"relates_to_kyc_check_id":"PlaceholderString"
}
-
CanAddKycMedia
- Please login to request this Role
- OBP-20001: User not logged in. Authentication is required!
- OBP-10001: Incorrect json format.
- OBP-30046: Customer not found. Please specify a valid value for CUSTOMER_ID.
- OBP-00004: Server error: could not add message
- OBP-50000: Unknown Error.
- OBP-20006: User is missing one or more roles:
Add KYC Status
Add a kyc_status for the customer specified by CUSTOMER_ID. KYC Status is a timeline of the KYC status of the customer
Authentication is Mandatory
URL Parameters:
-
BANK_ID: gh.29.uk
-
CUSTOMER_ID: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
JSON response body fields:
-
customer_id: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
-
customer_number: 5987953
-
date: 2020-01-27
-
ok: true
{
"customer_id":"7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh",
"customer_number":"5987953",
"ok":true,
"date":"2017-09-19T00:00:00Z"
}
-
CanAddKycStatus
- Please login to request this Role
- OBP-20001: User not logged in. Authentication is required!
- OBP-10001: Incorrect json format.
- OBP-30111: Invalid Bank Id. The BANK_ID should only contain 0-9/a-z/A-Z/'-'/'.'/'_', the length should be smaller than 255.
- OBP-50000: Unknown Error.
- OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
- OBP-00004: Server error: could not add message
- OBP-30046: Customer not found. Please specify a valid value for CUSTOMER_ID.
- OBP-20006: User is missing one or more roles:
Get Customer KYC Checks
Get KYC checks for the Customer specified by CUSTOMER_ID.
Authentication is Mandatory
URL Parameters:
- CUSTOMER_ID: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
JSON response body fields:
-
bank_id: gh.29.uk
-
customer_id: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
-
customer_number: 5987953
-
date: 2020-01-27
-
satisfied: true
{
"checks":[{
"bank_id":"gh.29.uk",
"customer_id":"7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh",
"id":"PlaceholderString",
"customer_number":"5987953",
"date":"2017-09-19T00:00:00Z",
"how":"PlaceholderString",
"staff_user_id":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
"staff_name":"PlaceholderString",
"satisfied":true,
"comments":"PlaceholderString"
}]
}
-
CanGetAnyKycChecks
- Please login to request this Role
- OBP-20001: User not logged in. Authentication is required!
- OBP-30046: Customer not found. Please specify a valid value for CUSTOMER_ID.
- OBP-50000: Unknown Error.
- OBP-20006: User is missing one or more roles:
Get Customer KYC Documents
Get KYC (know your customer) documents for a customer specified by CUSTOMER_ID
Get a list of documents that affirm the identity of the customer
Passport, driving licence etc.
Authentication is Optional
Authentication is Mandatory
URL Parameters:
- CUSTOMER_ID: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
JSON response body fields:
-
bank_id: gh.29.uk
-
customer_id: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
-
customer_number: 5987953
-
expiry_date: 2021-01-27
-
issue_date: 2020-01-27
{
"documents":[{
"bank_id":"gh.29.uk",
"customer_id":"7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh",
"id":"PlaceholderString",
"customer_number":"5987953",
"type":"PlaceholderString",
"number":"PlaceholderString",
"issue_date":"2017-09-19T00:00:00Z",
"issue_place":"PlaceholderString",
"expiry_date":"2017-09-19T00:00:00Z"
}]
}
-
CanGetAnyKycDocuments
- Please login to request this Role
- OBP-20001: User not logged in. Authentication is required!
- OBP-30046: Customer not found. Please specify a valid value for CUSTOMER_ID.
- OBP-50000: Unknown Error.
- OBP-20006: User is missing one or more roles:
Get Customer KYC statuses
Get the KYC statuses for a customer specified by CUSTOMER_ID over time.
Authentication is Mandatory
URL Parameters:
- CUSTOMER_ID: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
JSON response body fields:
-
customer_id: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
-
customer_number: 5987953
-
date: 2020-01-27
-
ok: true
{
"statuses":[{
"customer_id":"7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh",
"customer_number":"5987953",
"ok":true,
"date":"2017-09-19T00:00:00Z"
}]
}
-
CanGetAnyKycStatuses
- Please login to request this Role
- OBP-20001: User not logged in. Authentication is required!
- OBP-30046: Customer not found. Please specify a valid value for CUSTOMER_ID.
- OBP-50000: Unknown Error.
- OBP-20006: User is missing one or more roles:
Get KYC Media for a customer
Get KYC media (scans, pictures, videos) that affirms the identity of the customer.
Authentication is Mandatory
URL Parameters:
- CUSTOMER_ID: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
JSON response body fields:
-
bank_id: gh.29.uk
-
customer_id: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh
-
customer_number: 5987953
-
date: 2020-01-27
{
"medias":[{
"bank_id":"gh.29.uk",
"customer_id":"PlaceholderString",
"id":"PlaceholderString",
"customer_number":"5987953",
"type":"PlaceholderString",
"url":"PlaceholderString",
"date":"2017-09-19T00:00:00Z",
"relates_to_kyc_document_id":"PlaceholderString",
"relates_to_kyc_check_id":"PlaceholderString"
}]
}
-
CanGetAnyKycMedia
- Please login to request this Role
- OBP-20001: User not logged in. Authentication is required!
- OBP-30046: Customer not found. Please specify a valid value for CUSTOMER_ID.
- OBP-50000: Unknown Error.
- OBP-20006: User is missing one or more roles: