Post apiv2backofficemonetizationsbulk

cURL

curl --request POST \
  --url https://sandbox.killb.app/api/v2/backoffice/monetizations/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "monetizations": [
    {
      "fromCurrency": "USD",
      "toCurrency": "COP",
      "fromAmount": 100000,
      "toAmount": 420000000,
      "fxRate": 4200,
      "tradeDate": "2025-09-29T15:00:00Z",
      "status": "PENDING",
      "outProviderCode": "CITI",
      "inProviderCode": "BANCOLOMBIA",
      "metadata": {
        "note": "Liquidity for payroll"
      }
    }
  ]
}
'

{
  "successful": [
    {
      "id": "4d23aa52-1b40-4584-a8ea-58aba6099c5c",
      "fromCurrency": "USD",
      "toCurrency": "COP",
      "fromAmount": 100000,
      "toAmount": 420000000,
      "fxRate": 4200,
      "tradeDate": "2025-09-29T15:00:00.000Z",
      "outProviderCode": "CITI",
      "inProviderCode": "BANCOLOMBIA",
      "createdAt": "2025-09-29T15:00:00.000Z",
      "updatedAt": "2025-09-29T15:00:00.000Z",
      "metadata": {
        "note": "Liquidity for payroll"
      }
    }
  ],
  "failed": [
    {
      "index": 0,
      "error": "fromCurrency and toCurrency must be different",
      "type": "BadRequestException"
    }
  ],
  "totalRequested": 5,
  "totalSuccessful": 3,
  "totalFailed": 2
}

POST

api

backoffice

monetizations

bulk

cURL

curl --request POST \
  --url https://sandbox.killb.app/api/v2/backoffice/monetizations/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "monetizations": [
    {
      "fromCurrency": "USD",
      "toCurrency": "COP",
      "fromAmount": 100000,
      "toAmount": 420000000,
      "fxRate": 4200,
      "tradeDate": "2025-09-29T15:00:00Z",
      "status": "PENDING",
      "outProviderCode": "CITI",
      "inProviderCode": "BANCOLOMBIA",
      "metadata": {
        "note": "Liquidity for payroll"
      }
    }
  ]
}
'

{
  "successful": [
    {
      "id": "4d23aa52-1b40-4584-a8ea-58aba6099c5c",
      "fromCurrency": "USD",
      "toCurrency": "COP",
      "fromAmount": 100000,
      "toAmount": 420000000,
      "fxRate": 4200,
      "tradeDate": "2025-09-29T15:00:00.000Z",
      "outProviderCode": "CITI",
      "inProviderCode": "BANCOLOMBIA",
      "createdAt": "2025-09-29T15:00:00.000Z",
      "updatedAt": "2025-09-29T15:00:00.000Z",
      "metadata": {
        "note": "Liquidity for payroll"
      }
    }
  ],
  "failed": [
    {
      "index": 0,
      "error": "fromCurrency and toCurrency must be different",
      "type": "BadRequestException"
    }
  ],
  "totalRequested": 5,
  "totalSuccessful": 3,
  "totalFailed": 2
}

Authorizations

Authorization

string

header

required

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

Body

application/json

monetizations

object[]

required

Array of monetizations to create

Required array length: 1 - 100 elements

Show child attributes

monetizations.fromCurrency

string

required

Source currency (ISO 4217 or crypto ticker)

Example:

"USD"

monetizations.toCurrency

string

required

Target currency (ISO 4217 or crypto ticker)

Example:

"COP"

monetizations.fromAmount

number

required

Amount to be sent in source currency

Required range: x >= 0

Example:

100000

monetizations.toAmount

number

required

Amount to be received in target currency

Required range: x >= 0

Example:

420000000

monetizations.fxRate

number

required

Effective FX rate applied (after margin)

Required range: x > 0

Example:

4200

monetizations.tradeDate

string

required

Date and time of the operation (ISO 8601)

Example:

"2025-09-29T15:00:00Z"

monetizations.status

enum<string>

default:PENDING

required

Status of the monetization

Available options:

PENDING,

SETTLED,

CANCELED

Example:

"PENDING"

monetizations.outProviderCode

string

required

Code of the provider where funds are sent

Example:

"CITI"

monetizations.inProviderCode

string

required

Code of the provider where funds are received

Example:

"BANCOLOMBIA"

monetizations.metadata

object

Optional metadata for the operation

Example:

{ "note": "Liquidity for payroll" }

Response

successful

object[]

required

Successfully created monetizations

Show child attributes

successful.id

string

required

Example:

"4d23aa52-1b40-4584-a8ea-58aba6099c5c"

successful.fromCurrency

string

required

Example:

"USD"

successful.toCurrency

string

required

Example:

"COP"

successful.fromAmount

number

required

Example:

100000

successful.toAmount

number

required

Example:

420000000

successful.fxRate

number

required

Example:

4200

successful.tradeDate

string<date-time>

required

Example:

"2025-09-29T15:00:00.000Z"

successful.outProviderCode

string

required

Example:

"CITI"

successful.inProviderCode

string

required

Example:

"BANCOLOMBIA"

successful.createdAt

string<date-time>

required

Example:

"2025-09-29T15:00:00.000Z"

successful.updatedAt

string<date-time>

required

Example:

"2025-09-29T15:00:00.000Z"

successful.metadata

object

Example:

{ "note": "Liquidity for payroll" }

failed

object[]

required

Failed monetizations with error details

Show child attributes

failed.index

number

required

Example:

0

failed.error

string

required

Example:

"fromCurrency and toCurrency must be different"

failed.type

string

required

Example:

"BadRequestException"

totalRequested

number

required

Example:

5

totalSuccessful

number

required

Example:

3

totalFailed

number

required

Example:

2

Options Options

⌘I

Introduction

Endpoints

Post apiv2backofficemonetizationsbulk

Authorizations

Body

Response