{"swagger":"2.0","info":{"title":"Open Bank Project API","description":"An Open Source API for Banks. (c) TESOBE GmbH. 2011 - 2026. Licensed under the AGPL and commercial licences.","contact":{"name":"TESOBE GmbH. / Open Bank Project","url":"https://openbankproject.com","email":"contact@tesobe.com"},"version":"v5.1.0"},"host":"apisandbox.openbankproject.com","basePath":"/","schemes":["http","https"],"securityDefinitions":{"directLogin":{"type":"apiKey","description":"Direct Login authentication. POST to /obp/v6.0.0/my/logins/direct with header 'DirectLogin: username=YOUR_USERNAME, password=YOUR_PASSWORD, consumer_key=YOUR_CONSUMER_KEY' to obtain a token. Then use header 'DirectLogin: token=YOUR_TOKEN' on subsequent requests. See the OpenAPI 3.1 spec for full details.","in":"header","name":"DirectLogin"},"gatewayLogin":{"type":"apiKey","description":"Gateway Login authentication. The gateway sends a JWT in the Authorization header signed with a pre-shared secret. See the OpenAPI 3.1 spec for full details.","in":"header","name":"Authorization"}},"security":[{"directLogin":[],"gatewayLogin":[]}],"paths":{"/obp/v5.1.0/banks/{BANK_ID}/agents":{"post":{"tags":["Customer","Person"],"summary":"Create Agent","security":[{"directLogin":[],"gatewayLogin":[]}],"description":"

User Authentication is Required. The User must be logged in. The Application must also be authenticated.

URL Parameters:

BANK_ID: gh.29.uk

JSON request body fields:

agent_number: 5987953

currency: EUR

legal_name: Eveline Tripman

mobile_phone_number: +49 30 901820

JSON response body fields:

agent_id: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh

agent_number: 5987953

bank_id: gh.29.uk

currency: EUR

is_confirmed_agent: is_confirmed_agent

is_pending_agent: is_pending_agent

legal_name: Eveline Tripman

mobile_phone_number: +49 30 901820

","operationId":"OBPv5.1.0-createAgent","parameters":[{"in":"body","name":"body","description":"PostAgentJsonV510 object that needs to be added.","required":true,"schema":{"$ref":"#/definitions/PostAgentJsonV510"}},{"in":"path","name":"BANK_ID","description":"The bank id","required":true,"type":"string"}],"responses":{"201":{"description":"Success","schema":{"$ref":"#/definitions/AgentJsonV510"}},"400":{"description":"Error","schema":{"$ref":"#/definitions/ErrorAuthenticatedUserIsRequired"}}}}},"/obp/v5.1.0/banks/{BANK_ID}/agents/AGENT_ID":{"put":{"tags":["Customer","Person"],"summary":"Update Agent status","security":[{"directLogin":[],"gatewayLogin":[]}],"description":"

User Authentication is Required. The User must be logged in. The Application must also be authenticated.

URL Parameters:

AGENT_ID: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh

BANK_ID: gh.29.uk

JSON response body fields:

agent_id: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh

agent_number: 5987953

bank_id: gh.29.uk

currency: EUR

is_confirmed_agent: is_confirmed_agent

is_pending_agent: is_pending_agent

legal_name: Eveline Tripman

mobile_phone_number: +49 30 901820

","operationId":"OBPv5.1.0-updateAgentStatus","parameters":[{"in":"body","name":"body","description":"PutAgentJsonV510 object that needs to be added.","required":true,"schema":{"$ref":"#/definitions/PutAgentJsonV510"}},{"in":"path","name":"BANK_ID","description":"The bank id","required":true,"type":"string"}],"responses":{"200":{"description":"Success","schema":{"$ref":"#/definitions/AgentJsonV510"}},"400":{"description":"Error","schema":{"$ref":"#/definitions/ErrorAuthenticatedUserIsRequired"}}}}},"/obp/v5.1.0/banks/{BANK_ID}/customer/{CUSTOMER_ID}/messages":{"post":{"tags":["Customer-Message","Customer","Person"],"summary":"Create Customer Message","security":[{"directLogin":[],"gatewayLogin":[]}],"description":"

Create a message for the customer specified by CUSTOMER_ID

User Authentication is Required. The User must be logged in. The Application must also be authenticated.

URL Parameters:

BANK_ID: gh.29.uk

CUSTOMER_ID: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh

JSON request body fields:

from_department: Open Bank

from_person: Tom

message: 123456

JSON response body fields:

success:

","operationId":"OBPv1.4.0-addCustomerMessage","parameters":[{"in":"body","name":"body","description":"AddCustomerMessageJson object that needs to be added.","required":true,"schema":{"$ref":"#/definitions/AddCustomerMessageJson"}},{"in":"path","name":"CUSTOMER_ID","description":"The customer id","required":true,"type":"string"},{"in":"path","name":"BANK_ID","description":"The bank id","required":true,"type":"string"}],"responses":{"201":{"description":"Success","schema":{"$ref":"#/definitions/SuccessMessage"}},"400":{"description":"Error","schema":{"$ref":"#/definitions/ErrorAuthenticatedUserIsRequired"}}}}},"/obp/v5.1.0/banks/{BANK_ID}/customers":{"post":{"tags":["Customer","Person"],"summary":"Create Customer","security":[{"directLogin":[],"gatewayLogin":[]}],"description":"

The Customer resource stores the customer number (which is set by the backend), legal name, email, phone number, their date of birth, relationship status, education attained, a url for a profile image, KYC status etc.
Dates need to be in the format 2013-01-21T23:08:00Z

If kyc_status is not provided, it defaults to false.

Note: If you need to set a specific customer number, use the Update Customer Number endpoint after this call.

User Authentication is Required. The User must be logged in. The Application must also be authenticated.

URL Parameters:

BANK_ID: gh.29.uk

JSON request body fields:

amount: 10.12

currency: EUR

date: 2020-01-27

legal_name: Eveline Tripman

mobile_phone_number: +49 30 901820

rating:

source:

url: http://www.example.com/id-docs/123/image.png

branch_id: DERBY6

credit_limit:

credit_rating:

customer_number: 5987953

date_of_birth: 2018-03-09

dependants: 1

dob_of_dependants: [2019-09-08, 2017-07-12]

email: felixsmith@example.com

employment_status: worker

face_image:

highest_education_attained: Master

kyc_status: false

last_ok_date: 2025-05-09T14:09:15.662Z

name_suffix: Sr

relationship_status: single

title: Dr.

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

dependants: 1

dob_of_dependants: [2019-09-08, 2017-07-12]

email: felixsmith@example.com

employment_status: worker

face_image:

highest_education_attained: Master

kyc_status: false

last_ok_date: 2025-05-09T14:09:15.662Z

legal_name: Eveline Tripman

mobile_phone_number: +49 30 901820

name_suffix: Sr

rating:

relationship_status: single

source:

title: Dr.

url: http://www.example.com/id-docs/123/image.png

credit_limit:

credit_rating:

","operationId":"OBPv5.0.0-createCustomer","parameters":[{"in":"body","name":"body","description":"PostCustomerJsonV500 object that needs to be added.","required":true,"schema":{"$ref":"#/definitions/PostCustomerJsonV500"}},{"in":"path","name":"BANK_ID","description":"The bank id","required":true,"type":"string"}],"responses":{"201":{"description":"Success","schema":{"$ref":"#/definitions/CustomerJsonV310"}},"400":{"description":"Error","schema":{"$ref":"#/definitions/ErrorAuthenticatedUserIsRequired"}}}}},"/obp/v5.1.0/banks/{BANK_ID}/customers/{CUSTOMER_ID}/messages":{"post":{"tags":["Customer-Message","Customer","Person"],"summary":"Create Customer Message","security":[{"directLogin":[],"gatewayLogin":[]}],"description":"

Create a message for the customer specified by CUSTOMER_ID
User Authentication is Required. The User must be logged in. The Application must also be authenticated.

URL Parameters:

BANK_ID: gh.29.uk

CUSTOMER_ID: 7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh

JSON request body fields:

from_department: Open Bank

from_person: Tom

message: 123456

transport: SMS

JSON response body fields:

success:

","operationId":"OBPv4.0.0-createCustomerMessage","parameters":[{"in":"body","name":"body","description":"CreateMessageJsonV400 object that needs to be added.","required":true,"schema":{"$ref":"#/definitions/CreateMessageJsonV400"}},{"in":"path","name":"CUSTOMER_ID","description":"The customer id","required":true,"type":"string"},{"in":"path","name":"BANK_ID","description":"The bank id","required":true,"type":"string"}],"responses":{"201":{"description":"Success","schema":{"$ref":"#/definitions/SuccessMessage"}},"400":{"description":"Error","schema":{"$ref":"#/definitions/ErrorAuthenticatedUserIsRequired"}}}}}},"definitions":{"ErrorAuthenticatedUserIsRequired":{"properties":{"message":{"type":"string","example":"OBP-20001: User not logged in. Authentication is required!"}}},"PostCustomerJsonV500":{"required":["mobile_phone_number","legal_name"],"properties":{"name_suffix":{"type":"string","example":"Sr"},"email":{"type":"string","example":"felixsmith@example.com"},"branch_id":{"type":"string","example":"DERBY6"},"mobile_phone_number":{"type":"string","example":"+49 30 901820"},"customer_number":{"type":"string","example":"5987953"},"highest_education_attained":{"type":"string","example":"Master"},"dob_of_dependants":{"type":"array","items":{"type":"string","format":"date"}},"date_of_birth":{"type":"string","format":"date","example":"1100-01-01T00:00:00Z"},"credit_rating":{"$ref":"#/definitions/CustomerCreditRatingJSON"},"last_ok_date":{"type":"string","format":"date","example":"2025-05-09T14:09:18Z"},"employment_status":{"type":"string","example":"worker"},"legal_name":{"type":"string","example":"Eveline Tripman"},"credit_limit":{"$ref":"#/definitions/AmountOfMoneyJsonV121"},"title":{"type":"string","example":"Dr."},"face_image":{"$ref":"#/definitions/CustomerFaceImageJson"},"dependants":{"type":"integer","format":"int32","example":"1"},"relationship_status":{"type":"string","example":"single"},"kyc_status":{"type":"boolean","example":"false"}}},"CreateMessageJsonV400":{"required":["message","transport","from_department","from_person"],"properties":{"message":{"type":"string","example":"123456"},"transport":{"type":"string","example":"SMS"},"from_department":{"type":"string","example":"Open Bank"},"from_person":{"type":"string","example":"Tom"}}},"PostAgentJsonV510":{"required":["legal_name","mobile_phone_number","agent_number","currency"],"properties":{"legal_name":{"type":"string","example":"Eveline Tripman"},"mobile_phone_number":{"type":"string","example":"+49 30 901820"},"agent_number":{"type":"string","example":"5987953"},"currency":{"type":"string","example":"EUR"}}},"PutAgentJsonV510":{"required":["is_pending_agent","is_confirmed_agent"],"properties":{"is_pending_agent":{"type":"boolean","example":"false"},"is_confirmed_agent":{"type":"boolean","example":"true"}}},"AddCustomerMessageJson":{"required":["message","from_department","from_person"],"properties":{"message":{"type":"string","example":"String"},"from_department":{"type":"string","example":"String"},"from_person":{"type":"string","example":"String"}}},"CustomerJsonV310":{"required":["customer_id","name_suffix","email","branch_id","mobile_phone_number","customer_number","highest_education_attained","dob_of_dependants","bank_id","date_of_birth","last_ok_date","employment_status","legal_name","title","face_image","dependants","relationship_status","kyc_status"],"properties":{"customer_id":{"type":"string","example":"7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh"},"name_suffix":{"type":"string","example":"Sr"},"email":{"type":"string","example":"felixsmith@example.com"},"branch_id":{"type":"string","example":"DERBY6"},"mobile_phone_number":{"type":"string","example":"+44 07972 444 876"},"customer_number":{"type":"string","example":"5987953"},"highest_education_attained":{"type":"string","example":"Master"},"dob_of_dependants":{"type":"array","items":{"type":"string","format":"date"}},"bank_id":{"type":"string","example":"gh.29.uk"},"date_of_birth":{"type":"string","format":"date","example":"1100-01-01T00:00:00Z"},"credit_rating":{"$ref":"#/definitions/CustomerCreditRatingJSON"},"last_ok_date":{"type":"string","format":"date","example":"2025-05-09T14:09:16Z"},"employment_status":{"type":"string","example":"worker"},"legal_name":{"type":"string","example":"Eveline Tripman"},"credit_limit":{"$ref":"#/definitions/AmountOfMoneyJsonV121"},"title":{"type":"string","example":"Dr."},"face_image":{"$ref":"#/definitions/CustomerFaceImageJson"},"dependants":{"type":"integer","format":"int32","example":"1"},"relationship_status":{"type":"string","example":"single"},"kyc_status":{"type":"boolean","example":"false"}}},"SuccessMessage":{"required":["success"],"properties":{"success":{"type":"string","example":"Success"}}},"AgentJsonV510":{"required":["agent_number","mobile_phone_number","bank_id","currency","legal_name","is_confirmed_agent","is_pending_agent","agent_id"],"properties":{"agent_number":{"type":"string","example":"5987953"},"mobile_phone_number":{"type":"string","example":"+49 30 901820"},"bank_id":{"type":"string","example":"gh.29.uk"},"currency":{"type":"string","example":"EUR"},"legal_name":{"type":"string","example":"Eveline Tripman"},"is_confirmed_agent":{"type":"boolean","example":"false"},"is_pending_agent":{"type":"boolean","example":"true"},"agent_id":{"type":"string","example":"7uy8a7e4-6d02-40e3-a129-0b2bf89de8uh"}}},"CustomerFaceImageJson":{"required":["url","date"],"properties":{"url":{"type":"string","example":"www.openbankproject"},"date":{"type":"string","format":"date","example":"1100-01-01T00:00:00Z"}}},"CustomerCreditRatingJSON":{"required":["rating","source"],"properties":{"rating":{"type":"string","example":"OBP"},"source":{"type":"string","example":"OBP"}}},"AmountOfMoneyJsonV121":{"required":["currency","amount"],"properties":{"currency":{"type":"string","example":"EUR"},"amount":{"type":"string","example":"0"}}}}}