right logo image
right logo image
Log on
⯆

API Explorer

Log off

v5.1.0 (533 APIs)

API Host: https://obp-api-sandbox.nmbbank.co.tz
Bank
Accounts
Views
Counterparties
Transactions

Create Bank Level Dynamic Entity

Create a Bank Level DynamicEntity.

Authentication is Mandatory

Create a DynamicEntity. If creation is successful, the corresponding POST, GET, PUT and DELETE (Create, Read, Update, Delete or CRUD for short) endpoints will be generated automatically

The following field types are as supported:
[number, integer, boolean, string, DATE_WITH_DAY, reference]

The DATE_WITH_DAY format is: yyyy-MM-dd

Reference types are like foreign keys and composite foreign keys are supported. The value you need to supply as the (composite) foreign key is a UUID (or several UUIDs in the case of a composite key) that match value in another Entity..
The following list shows all the possible reference types in the system with corresponding examples values so you can see how to construct each reference type value.

"someField0": {
    "type": "reference:Bank",
    "example": "3e32aa5a-10e8-44a3-9ceb-b0d120200e54"
}

"someField1": {
    "type": "reference:Consumer",
    "example": "3e32aa5a-10e8-44a3-9ceb-b0d120200e54"
}

"someField2": {
    "type": "reference:Customer",
    "example": "3e32aa5a-10e8-44a3-9ceb-b0d120200e54"
}

"someField3": {
    "type": "reference:MethodRouting",
    "example": "3e32aa5a-10e8-44a3-9ceb-b0d120200e54"
}

"someField4": {
    "type": "reference:DynamicEntity",
    "example": "3e32aa5a-10e8-44a3-9ceb-b0d120200e54"
}

"someField5": {
    "type": "reference:TransactionRequest",
    "example": "3e32aa5a-10e8-44a3-9ceb-b0d120200e54"
}

"someField6": {
    "type": "reference:ProductAttribute",
    "example": "3e32aa5a-10e8-44a3-9ceb-b0d120200e54"
}

"someField7": {
    "type": "reference:AccountAttribute",
    "example": "3e32aa5a-10e8-44a3-9ceb-b0d120200e54"
}

"someField8": {
    "type": "reference:TransactionAttribute",
    "example": "3e32aa5a-10e8-44a3-9ceb-b0d120200e54"
}

"someField9": {
    "type": "reference:CustomerAttribute",
    "example": "3e32aa5a-10e8-44a3-9ceb-b0d120200e54"
}

"someField10": {
    "type": "reference:AccountApplication",
    "example": "3e32aa5a-10e8-44a3-9ceb-b0d120200e54"
}

"someField11": {
    "type": "reference:CardAttribute",
    "example": "3e32aa5a-10e8-44a3-9ceb-b0d120200e54"
}

"someField12": {
    "type": "reference:Counterparty",
    "example": "3e32aa5a-10e8-44a3-9ceb-b0d120200e54"
}

"someField13": {
    "type": "reference:Branch:bankId&branchId",
    "example": "bankId=3e32aa5a-10e8-44a3-9ceb-b0d120200e54&branchId=eb4d4b57-810c-40a2-9648-dec732ecf9b4"
}

"someField14": {
    "type": "reference:Atm:bankId&atmId",
    "example": "bankId=3e32aa5a-10e8-44a3-9ceb-b0d120200e54&atmId=eb4d4b57-810c-40a2-9648-dec732ecf9b4"
}

"someField15": {
    "type": "reference:BankAccount:bankId&accountId",
    "example": "bankId=3e32aa5a-10e8-44a3-9ceb-b0d120200e54&accountId=eb4d4b57-810c-40a2-9648-dec732ecf9b4"
}

"someField16": {
    "type": "reference:Product:bankId&productCode",
    "example": "bankId=3e32aa5a-10e8-44a3-9ceb-b0d120200e54&productCode=eb4d4b57-810c-40a2-9648-dec732ecf9b4"
}

"someField17": {
    "type": "reference:PhysicalCard:bankId&cardId",
    "example": "bankId=3e32aa5a-10e8-44a3-9ceb-b0d120200e54&cardId=eb4d4b57-810c-40a2-9648-dec732ecf9b4"
}

"someField18": {
    "type": "reference:Transaction:bankId&accountId&transactionId",
    "example": "bankId=3e32aa5a-10e8-44a3-9ceb-b0d120200e54&accountId=eb4d4b57-810c-40a2-9648-dec732ecf9b4&transactionId=20215666-dfce-47fe-86ee-3c793b9aef4a"
}

"someField19": {
    "type": "reference:Counterparty:bankId&accountId&counterpartyId",
    "example": "bankId=3e32aa5a-10e8-44a3-9ceb-b0d120200e54&accountId=eb4d4b57-810c-40a2-9648-dec732ecf9b4&counterpartyId=20215666-dfce-47fe-86ee-3c793b9aef4a"
}

Note: if you set hasPersonalEntity = false, then OBP will not generate the CRUD my FooBar endpoints.

Typical Successful Response: 

								
									
{
  "bankId":"gh.29.uk",
  "FooBar":{
    "description":"description of this entity, can be markdown text.",
    "required":["name"],
    "properties":{
      "name":{
        "type":"string",
        "minLength":3,
        "maxLength":20,
        "example":"James Brown",
        "description":"description of **name** field, can be markdown text."
      },
      "number":{
        "type":"integer",
        "example":698761728,
        "description":"description of **number** field, can be markdown text."
      }
    }
  },
  "dynamicEntityId":"dynamic-entity-id",
  "userId":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
  "hasPersonalEntity":true
}
Required Roles:
  • CanCreateBankLevelDynamicEntity - Please login to request this Role
Validations:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Possible Errors:
  • OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
  • 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.
Connector Methods:
Version: OBPv4.0.0, function_name: by createBankLevelDynamicEntity, operation_id: OBPv4.0.0-createBankLevelDynamicEntity Tags: Dynamic-Entity-Manage, API,

Create System Level Dynamic Entity

Create a system level Dynamic Entity.

Authentication is Mandatory

Create a DynamicEntity. If creation is successful, the corresponding POST, GET, PUT and DELETE (Create, Read, Update, Delete or CRUD for short) endpoints will be generated automatically

The following field types are as supported:
[number, integer, boolean, string, DATE_WITH_DAY, reference]

The DATE_WITH_DAY format is: yyyy-MM-dd

Reference types are like foreign keys and composite foreign keys are supported. The value you need to supply as the (composite) foreign key is a UUID (or several UUIDs in the case of a composite key) that match value in another Entity..
See the following list of currently available reference types and examples of how to construct key values correctly. Note: As more Dynamic Entities are created on this instance, this list will grow:

"someField0": {
    "type": "reference:Bank",
    "example": "b87daa62-bfb5-48c2-a659-295261988edb"
}

"someField1": {
    "type": "reference:Consumer",
    "example": "b87daa62-bfb5-48c2-a659-295261988edb"
}

"someField2": {
    "type": "reference:Customer",
    "example": "b87daa62-bfb5-48c2-a659-295261988edb"
}

"someField3": {
    "type": "reference:MethodRouting",
    "example": "b87daa62-bfb5-48c2-a659-295261988edb"
}

"someField4": {
    "type": "reference:DynamicEntity",
    "example": "b87daa62-bfb5-48c2-a659-295261988edb"
}

"someField5": {
    "type": "reference:TransactionRequest",
    "example": "b87daa62-bfb5-48c2-a659-295261988edb"
}

"someField6": {
    "type": "reference:ProductAttribute",
    "example": "b87daa62-bfb5-48c2-a659-295261988edb"
}

"someField7": {
    "type": "reference:AccountAttribute",
    "example": "b87daa62-bfb5-48c2-a659-295261988edb"
}

"someField8": {
    "type": "reference:TransactionAttribute",
    "example": "b87daa62-bfb5-48c2-a659-295261988edb"
}

"someField9": {
    "type": "reference:CustomerAttribute",
    "example": "b87daa62-bfb5-48c2-a659-295261988edb"
}

"someField10": {
    "type": "reference:AccountApplication",
    "example": "b87daa62-bfb5-48c2-a659-295261988edb"
}

"someField11": {
    "type": "reference:CardAttribute",
    "example": "b87daa62-bfb5-48c2-a659-295261988edb"
}

"someField12": {
    "type": "reference:Counterparty",
    "example": "b87daa62-bfb5-48c2-a659-295261988edb"
}

"someField13": {
    "type": "reference:Branch:bankId&branchId",
    "example": "bankId=b87daa62-bfb5-48c2-a659-295261988edb&branchId=efd4fa16-0912-4c01-bcea-a662545c7f87"
}

"someField14": {
    "type": "reference:Atm:bankId&atmId",
    "example": "bankId=b87daa62-bfb5-48c2-a659-295261988edb&atmId=efd4fa16-0912-4c01-bcea-a662545c7f87"
}

"someField15": {
    "type": "reference:BankAccount:bankId&accountId",
    "example": "bankId=b87daa62-bfb5-48c2-a659-295261988edb&accountId=efd4fa16-0912-4c01-bcea-a662545c7f87"
}

"someField16": {
    "type": "reference:Product:bankId&productCode",
    "example": "bankId=b87daa62-bfb5-48c2-a659-295261988edb&productCode=efd4fa16-0912-4c01-bcea-a662545c7f87"
}

"someField17": {
    "type": "reference:PhysicalCard:bankId&cardId",
    "example": "bankId=b87daa62-bfb5-48c2-a659-295261988edb&cardId=efd4fa16-0912-4c01-bcea-a662545c7f87"
}

"someField18": {
    "type": "reference:Transaction:bankId&accountId&transactionId",
    "example": "bankId=b87daa62-bfb5-48c2-a659-295261988edb&accountId=efd4fa16-0912-4c01-bcea-a662545c7f87&transactionId=52dd0996-6640-407a-a841-410884da62ed"
}

"someField19": {
    "type": "reference:Counterparty:bankId&accountId&counterpartyId",
    "example": "bankId=b87daa62-bfb5-48c2-a659-295261988edb&accountId=efd4fa16-0912-4c01-bcea-a662545c7f87&counterpartyId=52dd0996-6640-407a-a841-410884da62ed"
}

Note: if you set hasPersonalEntity = false, then OBP will not generate the CRUD my FooBar endpoints.

Typical Successful Response: 

								
									
{
  "FooBar":{
    "description":"description of this entity, can be markdown text.",
    "required":["name"],
    "properties":{
      "name":{
        "type":"string",
        "minLength":3,
        "maxLength":20,
        "example":"James Brown",
        "description":"description of **name** field, can be markdown text."
      },
      "number":{
        "type":"integer",
        "example":698761728,
        "description":"description of **number** field, can be markdown text."
      }
    }
  },
  "dynamicEntityId":"dynamic-entity-id",
  "userId":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
  "hasPersonalEntity":true
}
Required Roles:
  • CanCreateSystemLevelDynamicEntity - Please login to request this Role
Validations:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Possible Errors:
  • 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.
Connector Methods:
Version: OBPv4.0.0, function_name: by createSystemDynamicEntity, operation_id: OBPv4.0.0-createSystemDynamicEntity Tags: Dynamic-Entity-Manage, API,

Delete Bank Level Dynamic Entity

Delete a Bank Level DynamicEntity specified by DYNAMIC_ENTITY_ID.

Authentication is Mandatory

Typical Successful Response:
Required Roles:
  • CanDeleteBankLevelDynamicEntity - Please login to request this Role
Validations:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Possible Errors:
  • OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-20006: User is missing one or more roles:
  • OBP-50000: Unknown Error.
Connector Methods:
Version: OBPv4.0.0, function_name: by deleteBankLevelDynamicEntity, operation_id: OBPv4.0.0-deleteBankLevelDynamicEntity Tags: Dynamic-Entity-Manage, API,

Delete My Dynamic Entity

Delete my DynamicEntity specified by DYNAMIC_ENTITY_ID.

Authentication is Mandatory

Typical Successful Response:
Validations:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Possible Errors:
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-50000: Unknown Error.
Connector Methods:
Version: OBPv4.0.0, function_name: by deleteMyDynamicEntity, operation_id: OBPv4.0.0-deleteMyDynamicEntity Tags: Dynamic-Entity-Manage, API,

Delete System Level Dynamic Entity

Delete a DynamicEntity specified by DYNAMIC_ENTITY_ID.

Authentication is Mandatory

Typical Successful Response:
Required Roles:
  • CanDeleteSystemLevelDynamicEntity - Please login to request this Role
Validations:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Possible Errors:
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-20006: User is missing one or more roles:
  • OBP-50000: Unknown Error.
Connector Methods:
Version: OBPv4.0.0, function_name: by deleteSystemDynamicEntity, operation_id: OBPv4.0.0-deleteSystemDynamicEntity Tags: Dynamic-Entity-Manage, API,

Get Bank Level Dynamic Entities

Get all the bank level Dynamic Entities for one bank.

Authentication is Mandatory

Typical Successful Response: 

								
									
{
  "dynamic_entities":[{
    "bankId":"gh.29.uk",
    "FooBar":{
      "description":"description of this entity, can be markdown text.",
      "required":["name"],
      "properties":{
        "name":{
          "type":"string",
          "minLength":3,
          "maxLength":20,
          "example":"James Brown",
          "description":"description of **name** field, can be markdown text."
        },
        "number":{
          "type":"integer",
          "example":698761728,
          "description":"description of **number** field, can be markdown text."
        }
      }
    },
    "dynamicEntityId":"dynamic-entity-id",
    "userId":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
    "hasPersonalEntity":true
  }]
}
Required Roles:
  • CanGetBankLevelDynamicEntities - Please login to request this Role
Validations:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Possible Errors:
  • OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-20006: User is missing one or more roles:
  • OBP-50000: Unknown Error.
Connector Methods:
Version: OBPv4.0.0, function_name: by getBankLevelDynamicEntities, operation_id: OBPv4.0.0-getBankLevelDynamicEntities Tags: Dynamic-Entity-Manage, API,

Get My Dynamic Entities

Get all my Dynamic Entities.

Authentication is Mandatory

Typical Successful Response: 

								
									
{
  "dynamic_entities":[{
    "bankId":"gh.29.uk",
    "FooBar":{
      "description":"description of this entity, can be markdown text.",
      "required":["name"],
      "properties":{
        "name":{
          "type":"string",
          "minLength":3,
          "maxLength":20,
          "example":"James Brown",
          "description":"description of **name** field, can be markdown text."
        },
        "number":{
          "type":"integer",
          "example":698761728,
          "description":"description of **number** field, can be markdown text."
        }
      }
    },
    "dynamicEntityId":"dynamic-entity-id",
    "userId":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
    "hasPersonalEntity":true
  }]
}
Validations:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Possible Errors:
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-50000: Unknown Error.
Connector Methods:
Version: OBPv4.0.0, function_name: by getMyDynamicEntities, operation_id: OBPv4.0.0-getMyDynamicEntities Tags: Dynamic-Entity-Manage, API,

Get System Dynamic Entities

Get all System Dynamic Entities

Authentication is Mandatory

Typical Successful Response: 

								
									
{
  "dynamic_entities":[{
    "bankId":"gh.29.uk",
    "FooBar":{
      "description":"description of this entity, can be markdown text.",
      "required":["name"],
      "properties":{
        "name":{
          "type":"string",
          "minLength":3,
          "maxLength":20,
          "example":"James Brown",
          "description":"description of **name** field, can be markdown text."
        },
        "number":{
          "type":"integer",
          "example":698761728,
          "description":"description of **number** field, can be markdown text."
        }
      }
    },
    "dynamicEntityId":"dynamic-entity-id",
    "userId":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
    "hasPersonalEntity":true
  }]
}
Required Roles:
  • CanGetSystemLevelDynamicEntities - Please login to request this Role
Validations:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Possible Errors:
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-20006: User is missing one or more roles:
  • OBP-50000: Unknown Error.
Connector Methods:
Version: OBPv4.0.0, function_name: by getSystemDynamicEntities, operation_id: OBPv4.0.0-getSystemDynamicEntities Tags: Dynamic-Entity-Manage, API,

Update Bank Level Dynamic Entity

Update a Bank Level DynamicEntity.

Authentication is Mandatory

Update one DynamicEntity, after update finished, the corresponding CRUD endpoints will be changed.

The following field types are as supported:
[number, integer, boolean, string, DATE_WITH_DAY, reference]

DATE_WITH_DAY format: yyyy-MM-dd

Reference types are like foreign keys and composite foreign keys are supported. The value you need to supply as the (composite) foreign key is a UUID (or several UUIDs in the case of a composite key) that match value in another Entity..
The following list shows all the possible reference types in the system with corresponding examples values so you can see how to construct each reference type value.

"someField0": {
    "type": "reference:Bank",
    "example": "8393928f-4613-477c-8dbb-62a878e3dc39"
}

"someField1": {
    "type": "reference:Consumer",
    "example": "8393928f-4613-477c-8dbb-62a878e3dc39"
}

"someField2": {
    "type": "reference:Customer",
    "example": "8393928f-4613-477c-8dbb-62a878e3dc39"
}

"someField3": {
    "type": "reference:MethodRouting",
    "example": "8393928f-4613-477c-8dbb-62a878e3dc39"
}

"someField4": {
    "type": "reference:DynamicEntity",
    "example": "8393928f-4613-477c-8dbb-62a878e3dc39"
}

"someField5": {
    "type": "reference:TransactionRequest",
    "example": "8393928f-4613-477c-8dbb-62a878e3dc39"
}

"someField6": {
    "type": "reference:ProductAttribute",
    "example": "8393928f-4613-477c-8dbb-62a878e3dc39"
}

"someField7": {
    "type": "reference:AccountAttribute",
    "example": "8393928f-4613-477c-8dbb-62a878e3dc39"
}

"someField8": {
    "type": "reference:TransactionAttribute",
    "example": "8393928f-4613-477c-8dbb-62a878e3dc39"
}

"someField9": {
    "type": "reference:CustomerAttribute",
    "example": "8393928f-4613-477c-8dbb-62a878e3dc39"
}

"someField10": {
    "type": "reference:AccountApplication",
    "example": "8393928f-4613-477c-8dbb-62a878e3dc39"
}

"someField11": {
    "type": "reference:CardAttribute",
    "example": "8393928f-4613-477c-8dbb-62a878e3dc39"
}

"someField12": {
    "type": "reference:Counterparty",
    "example": "8393928f-4613-477c-8dbb-62a878e3dc39"
}

"someField13": {
    "type": "reference:Branch:bankId&branchId",
    "example": "bankId=8393928f-4613-477c-8dbb-62a878e3dc39&branchId=5be9c968-40eb-4cc3-8eda-1418072904c9"
}

"someField14": {
    "type": "reference:Atm:bankId&atmId",
    "example": "bankId=8393928f-4613-477c-8dbb-62a878e3dc39&atmId=5be9c968-40eb-4cc3-8eda-1418072904c9"
}

"someField15": {
    "type": "reference:BankAccount:bankId&accountId",
    "example": "bankId=8393928f-4613-477c-8dbb-62a878e3dc39&accountId=5be9c968-40eb-4cc3-8eda-1418072904c9"
}

"someField16": {
    "type": "reference:Product:bankId&productCode",
    "example": "bankId=8393928f-4613-477c-8dbb-62a878e3dc39&productCode=5be9c968-40eb-4cc3-8eda-1418072904c9"
}

"someField17": {
    "type": "reference:PhysicalCard:bankId&cardId",
    "example": "bankId=8393928f-4613-477c-8dbb-62a878e3dc39&cardId=5be9c968-40eb-4cc3-8eda-1418072904c9"
}

"someField18": {
    "type": "reference:Transaction:bankId&accountId&transactionId",
    "example": "bankId=8393928f-4613-477c-8dbb-62a878e3dc39&accountId=5be9c968-40eb-4cc3-8eda-1418072904c9&transactionId=52f5419b-ef0a-4f0e-8428-380e98af1677"
}

"someField19": {
    "type": "reference:Counterparty:bankId&accountId&counterpartyId",
    "example": "bankId=8393928f-4613-477c-8dbb-62a878e3dc39&accountId=5be9c968-40eb-4cc3-8eda-1418072904c9&counterpartyId=52f5419b-ef0a-4f0e-8428-380e98af1677"
}
Typical Successful Response: 

								
									
{
  "bankId":"gh.29.uk",
  "FooBar":{
    "description":"description of this entity, can be markdown text.",
    "required":["name"],
    "properties":{
      "name":{
        "type":"string",
        "minLength":3,
        "maxLength":20,
        "example":"James Brown",
        "description":"description of **name** field, can be markdown text."
      },
      "number":{
        "type":"integer",
        "example":698761728,
        "description":"description of **number** field, can be markdown text."
      }
    }
  },
  "dynamicEntityId":"dynamic-entity-id",
  "userId":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
  "hasPersonalEntity":true
}
Required Roles:
  • CanUpdateBankLevelDynamicEntity - Please login to request this Role
Validations:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Possible Errors:
  • OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
  • 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.
Connector Methods:
Version: OBPv4.0.0, function_name: by updateBankLevelDynamicEntity, operation_id: OBPv4.0.0-updateBankLevelDynamicEntity Tags: Dynamic-Entity-Manage, API,

Update My Dynamic Entity

Update my DynamicEntity.

Authentication is Mandatory

Update one of my DynamicEntity, after update finished, the corresponding CRUD endpoints will be changed.

Current support filed types as follow:
[number, integer, boolean, string, DATE_WITH_DAY, reference]

DATE_WITH_DAY format: yyyy-MM-dd

Reference types are like foreign keys and composite foreign keys are supported. The value you need to supply as the (composite) foreign key is a UUID (or several UUIDs in the case of a composite key) that match value in another Entity..
The following list shows all the possible reference types in the system with corresponding examples values so you can see how to construct each reference type value.

"someField0": {
    "type": "reference:Bank",
    "example": "7ea5ad03-a2d2-4f21-ad90-35e9493fa44f"
}

"someField1": {
    "type": "reference:Consumer",
    "example": "7ea5ad03-a2d2-4f21-ad90-35e9493fa44f"
}

"someField2": {
    "type": "reference:Customer",
    "example": "7ea5ad03-a2d2-4f21-ad90-35e9493fa44f"
}

"someField3": {
    "type": "reference:MethodRouting",
    "example": "7ea5ad03-a2d2-4f21-ad90-35e9493fa44f"
}

"someField4": {
    "type": "reference:DynamicEntity",
    "example": "7ea5ad03-a2d2-4f21-ad90-35e9493fa44f"
}

"someField5": {
    "type": "reference:TransactionRequest",
    "example": "7ea5ad03-a2d2-4f21-ad90-35e9493fa44f"
}

"someField6": {
    "type": "reference:ProductAttribute",
    "example": "7ea5ad03-a2d2-4f21-ad90-35e9493fa44f"
}

"someField7": {
    "type": "reference:AccountAttribute",
    "example": "7ea5ad03-a2d2-4f21-ad90-35e9493fa44f"
}

"someField8": {
    "type": "reference:TransactionAttribute",
    "example": "7ea5ad03-a2d2-4f21-ad90-35e9493fa44f"
}

"someField9": {
    "type": "reference:CustomerAttribute",
    "example": "7ea5ad03-a2d2-4f21-ad90-35e9493fa44f"
}

"someField10": {
    "type": "reference:AccountApplication",
    "example": "7ea5ad03-a2d2-4f21-ad90-35e9493fa44f"
}

"someField11": {
    "type": "reference:CardAttribute",
    "example": "7ea5ad03-a2d2-4f21-ad90-35e9493fa44f"
}

"someField12": {
    "type": "reference:Counterparty",
    "example": "7ea5ad03-a2d2-4f21-ad90-35e9493fa44f"
}

"someField13": {
    "type": "reference:Branch:bankId&branchId",
    "example": "bankId=7ea5ad03-a2d2-4f21-ad90-35e9493fa44f&branchId=0b2dac4f-8fef-495c-aed4-bcb57c54ca6d"
}

"someField14": {
    "type": "reference:Atm:bankId&atmId",
    "example": "bankId=7ea5ad03-a2d2-4f21-ad90-35e9493fa44f&atmId=0b2dac4f-8fef-495c-aed4-bcb57c54ca6d"
}

"someField15": {
    "type": "reference:BankAccount:bankId&accountId",
    "example": "bankId=7ea5ad03-a2d2-4f21-ad90-35e9493fa44f&accountId=0b2dac4f-8fef-495c-aed4-bcb57c54ca6d"
}

"someField16": {
    "type": "reference:Product:bankId&productCode",
    "example": "bankId=7ea5ad03-a2d2-4f21-ad90-35e9493fa44f&productCode=0b2dac4f-8fef-495c-aed4-bcb57c54ca6d"
}

"someField17": {
    "type": "reference:PhysicalCard:bankId&cardId",
    "example": "bankId=7ea5ad03-a2d2-4f21-ad90-35e9493fa44f&cardId=0b2dac4f-8fef-495c-aed4-bcb57c54ca6d"
}

"someField18": {
    "type": "reference:Transaction:bankId&accountId&transactionId",
    "example": "bankId=7ea5ad03-a2d2-4f21-ad90-35e9493fa44f&accountId=0b2dac4f-8fef-495c-aed4-bcb57c54ca6d&transactionId=f4c27811-173b-41ae-9fa5-531e412faa72"
}

"someField19": {
    "type": "reference:Counterparty:bankId&accountId&counterpartyId",
    "example": "bankId=7ea5ad03-a2d2-4f21-ad90-35e9493fa44f&accountId=0b2dac4f-8fef-495c-aed4-bcb57c54ca6d&counterpartyId=f4c27811-173b-41ae-9fa5-531e412faa72"
}
Typical Successful Response: 

								
									
{
  "bankId":"gh.29.uk",
  "FooBar":{
    "description":"description of this entity, can be markdown text.",
    "required":["name"],
    "properties":{
      "name":{
        "type":"string",
        "minLength":3,
        "maxLength":20,
        "example":"James Brown",
        "description":"description of **name** field, can be markdown text."
      },
      "number":{
        "type":"integer",
        "example":698761728,
        "description":"description of **number** field, can be markdown text."
      }
    }
  },
  "dynamicEntityId":"dynamic-entity-id",
  "userId":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
  "hasPersonalEntity":true
}
Validations:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Possible Errors:
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-10001: Incorrect json format.
  • OBP-09001: DynamicEntity not found. Please specify a valid value for DYNAMIC_ENTITY_ID.
  • OBP-50000: Unknown Error.
Connector Methods:
Version: OBPv4.0.0, function_name: by updateMyDynamicEntity, operation_id: OBPv4.0.0-updateMyDynamicEntity Tags: Dynamic-Entity-Manage, API,

Update System Level Dynamic Entity

Update a System Level Dynamic Entity.

Authentication is Mandatory

Update one DynamicEntity, after update finished, the corresponding CRUD endpoints will be changed.

The following field types are as supported:
[number, integer, boolean, string, DATE_WITH_DAY, reference]

DATE_WITH_DAY format: yyyy-MM-dd

Reference types are like foreign keys and composite foreign keys are supported. The value you need to supply as the (composite) foreign key is a UUID (or several UUIDs in the case of a composite key) that match value in another Entity..
The following list shows all the possible reference types in the system with corresponding examples values so you can see how to construct each reference type value.

"someField0": {
    "type": "reference:Bank",
    "example": "3e0551bf-1990-4dd2-a51f-b5e60fbba3f5"
}

"someField1": {
    "type": "reference:Consumer",
    "example": "3e0551bf-1990-4dd2-a51f-b5e60fbba3f5"
}

"someField2": {
    "type": "reference:Customer",
    "example": "3e0551bf-1990-4dd2-a51f-b5e60fbba3f5"
}

"someField3": {
    "type": "reference:MethodRouting",
    "example": "3e0551bf-1990-4dd2-a51f-b5e60fbba3f5"
}

"someField4": {
    "type": "reference:DynamicEntity",
    "example": "3e0551bf-1990-4dd2-a51f-b5e60fbba3f5"
}

"someField5": {
    "type": "reference:TransactionRequest",
    "example": "3e0551bf-1990-4dd2-a51f-b5e60fbba3f5"
}

"someField6": {
    "type": "reference:ProductAttribute",
    "example": "3e0551bf-1990-4dd2-a51f-b5e60fbba3f5"
}

"someField7": {
    "type": "reference:AccountAttribute",
    "example": "3e0551bf-1990-4dd2-a51f-b5e60fbba3f5"
}

"someField8": {
    "type": "reference:TransactionAttribute",
    "example": "3e0551bf-1990-4dd2-a51f-b5e60fbba3f5"
}

"someField9": {
    "type": "reference:CustomerAttribute",
    "example": "3e0551bf-1990-4dd2-a51f-b5e60fbba3f5"
}

"someField10": {
    "type": "reference:AccountApplication",
    "example": "3e0551bf-1990-4dd2-a51f-b5e60fbba3f5"
}

"someField11": {
    "type": "reference:CardAttribute",
    "example": "3e0551bf-1990-4dd2-a51f-b5e60fbba3f5"
}

"someField12": {
    "type": "reference:Counterparty",
    "example": "3e0551bf-1990-4dd2-a51f-b5e60fbba3f5"
}

"someField13": {
    "type": "reference:Branch:bankId&branchId",
    "example": "bankId=3e0551bf-1990-4dd2-a51f-b5e60fbba3f5&branchId=481cd6a1-0d48-4b26-be64-99cc5abe9958"
}

"someField14": {
    "type": "reference:Atm:bankId&atmId",
    "example": "bankId=3e0551bf-1990-4dd2-a51f-b5e60fbba3f5&atmId=481cd6a1-0d48-4b26-be64-99cc5abe9958"
}

"someField15": {
    "type": "reference:BankAccount:bankId&accountId",
    "example": "bankId=3e0551bf-1990-4dd2-a51f-b5e60fbba3f5&accountId=481cd6a1-0d48-4b26-be64-99cc5abe9958"
}

"someField16": {
    "type": "reference:Product:bankId&productCode",
    "example": "bankId=3e0551bf-1990-4dd2-a51f-b5e60fbba3f5&productCode=481cd6a1-0d48-4b26-be64-99cc5abe9958"
}

"someField17": {
    "type": "reference:PhysicalCard:bankId&cardId",
    "example": "bankId=3e0551bf-1990-4dd2-a51f-b5e60fbba3f5&cardId=481cd6a1-0d48-4b26-be64-99cc5abe9958"
}

"someField18": {
    "type": "reference:Transaction:bankId&accountId&transactionId",
    "example": "bankId=3e0551bf-1990-4dd2-a51f-b5e60fbba3f5&accountId=481cd6a1-0d48-4b26-be64-99cc5abe9958&transactionId=3aba009c-be9d-43b0-a5bf-6c9fb94c424c"
}

"someField19": {
    "type": "reference:Counterparty:bankId&accountId&counterpartyId",
    "example": "bankId=3e0551bf-1990-4dd2-a51f-b5e60fbba3f5&accountId=481cd6a1-0d48-4b26-be64-99cc5abe9958&counterpartyId=3aba009c-be9d-43b0-a5bf-6c9fb94c424c"
}
Typical Successful Response: 

								
									
{
  "FooBar":{
    "description":"description of this entity, can be markdown text.",
    "required":["name"],
    "properties":{
      "name":{
        "type":"string",
        "minLength":3,
        "maxLength":20,
        "example":"James Brown",
        "description":"description of **name** field, can be markdown text."
      },
      "number":{
        "type":"integer",
        "example":698761728,
        "description":"description of **number** field, can be markdown text."
      }
    }
  },
  "dynamicEntityId":"dynamic-entity-id",
  "userId":"9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
  "hasPersonalEntity":true
}
Required Roles:
  • CanUpdateSystemLevelDynamicEntity - Please login to request this Role
Validations:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Possible Errors:
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-20006: User is missing one or more roles:
  • OBP-09001: DynamicEntity not found. Please specify a valid value for DYNAMIC_ENTITY_ID.
  • OBP-10001: Incorrect json format.
  • OBP-50000: Unknown Error.
Connector Methods:
Version: OBPv4.0.0, function_name: by updateSystemDynamicEntity, operation_id: OBPv4.0.0-updateSystemDynamicEntity Tags: Dynamic-Entity-Manage, API,