[optional] Branch

Please use branches to segregate employees, customers and digital entity

Good to know: branches are essential for segregating access to entities and clients among employees. They serve as distinct divisions within an organization, allowing different teams or individuals to handle specific sets of entities and customers.

Branches of the counterparties are separate. An employee from one branch can see and work with customers only from his branch. If the employee is not assigned to any branch he/she can see all the customers of the Counterparty.

Working with branches you have the following features:

[optional] Branch

Create branch

Get Branch

Update Branch

Get the branches list and total branch entities

Get branches list and total branches count

get

Get branches list and total branches count

Path parameters
counterparty_guidstringRequired

Counterparty GUID

Query parameters
namesstring[]Optional

branches names filter (string)

guidsstring[]Optional

branches guids filter (uuid)

limitintegerOptional

limit (int)

offsetintegerOptional

offset (int)

orderstring · enumOptional

list order (string)

Possible values:
Responses
200
OK
application/json
get
GET /api/v1/counterparty/{counterparty_guid}/branches HTTP/1.1
Host: your_host
Accept: */*

{
  "list": [
    {
      "counterparty_guid": "text",
      "created_at": "text",
      "guid": "text",
      "is_deleted": true,
      "name": "text",
      "updated_at": "text"
    }
  ],
  "total": 1
}

Create branch

Create branch

post

Create branch

Path parameters
counterparty_guidstringRequired

Counterparty GUID

Body
namestringOptional

branch name

Responses
200
OK
application/json
post
POST /api/v1/counterparty/{counterparty_guid}/branches HTTP/1.1
Host: your_host
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "name": "text"
}
{
  "guid": "text"
}

Get Branch

Get branch

get

Get branch

Path parameters
counterparty_guidstringRequired

Counterparty GUID

branch_guidstringRequired

branch guid (uuid)

Responses
200
OK
application/json
get
GET /api/v1/counterparty/{counterparty_guid}/branches/{branch_guid} HTTP/1.1
Host: your_host
Accept: */*

{
  "counterparty_guid": "text",
  "created_at": "text",
  "guid": "text",
  "is_deleted": true,
  "name": "text",
  "updated_at": "text"
}

Update Branch

Update branch

put

Update branch

Path parameters
counterparty_guidstringRequired

Counterparty GUID

branch_guidstringRequired

branch guid (uuid)

Body
is_deletedbooleanOptional
namestringOptional
Responses
200
OK
application/json
Responseobject
put
PUT /api/v1/counterparty/{counterparty_guid}/branches/{branch_guid} HTTP/1.1
Host: your_host
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "is_deleted": true,
  "name": "text"
}
{}
PreviousReconciliationNextBranch access

Last updated