Skip to main content
PATCH
/
api
/
v2
/
backoffice
/
customers
/
liquidity
cURL
curl --request PATCH \
  --url https://sandbox.killb.app/api/v2/backoffice/customers/liquidity \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerId": "123e4567-e89b-12d3-a456-426614174000",
  "currency": "COP",
  "amount": 1000000,
  "origin": "API",
  "reason": "Manual adjustment by admin"
}
'
{
  "id": "123e4567-e89b-12d3-a456-426614174001",
  "customerId": "123e4567-e89b-12d3-a456-426614174000",
  "currency": "COP",
  "previousAmount": 500000,
  "currentAmount": 1000000,
  "origin": "API",
  "updatedAt": "2024-01-15T10:30:00.000Z"
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
customerId
string
required

Customer ID to update liquidity for

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
currency
string
default:COP
required

Currency code

Example:

"COP"

​
amount
number
required

New liquidity amount

Required range: x >= 0
Example:

1000000

​
origin
enum<string>
default:API
required

Origin of the liquidity update

Available options:
API,
OTC
Example:

"API"

​
reason
string

Reason for the liquidity update

Example:

"Manual adjustment by admin"

Response

​
id
string
required

Updated liquidity record ID

Example:

"123e4567-e89b-12d3-a456-426614174001"

​
customerId
string
required

Customer ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
currency
string
required

Currency code

Example:

"COP"

​
previousAmount
number
required

Previous amount

Example:

500000

​
currentAmount
number
required

New amount

Example:

1000000

​
origin
enum<string>
required

Origin of the update

Available options:
API,
OTC
Example:

"API"

​
updatedAt
string<date-time>
required

Update timestamp

Example:

"2024-01-15T10:30:00.000Z"