Skip to main content
GET
/
api
/
v2
/
payouts
List Payouts
curl --request GET \
  --url https://sandbox.killb.app/api/v2/payouts \
  --header 'Authorization: Bearer <token>'
{
  "payouts": [
    {
      "id": "e8d74b2f-86df-43b0-a9d9-72055a6b0432",
      "amount": 8000,
      "currency": "COP",
      "beneficiary": {
        "type": "BANK",
        "account": {
          "document": {
            "type": "NIT",
            "number": "123456",
            "issuedCountryCode": "CO"
          },
          "accountNumber": "10203049",
          "bankCode": "001",
          "type": "checking",
          "countryCode": "CO",
          "firstName": "John",
          "middleName": "Carlos",
          "lastName": "Doe",
          "companyName": "Acme Corp",
          "email": "[email protected]",
          "phone": "+576015555555"
        }
      },
      "status": "CASH_IN_CREATED",
      "createdAt": "2026-04-23T00:38:08.439Z",
      "updatedAt": "2026-04-23T00:38:08.439Z",
      "details": "Payment processed successfully",
      "transferProof": "https://example.com/proof.pdf",
      "externalId": "d00e4f43-2022-42f3-ba1c-dcf4c1dcd934",
      "metadata": {
        "orderId": "abc123",
        "channel": "mobile"
      }
    }
  ],
  "totalPage": 5
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
limit
number
Required range: 1 <= x <= 100
Example:

10

​
page
number
Required range: x >= 1
Example:

1

​
id
string
Example:

"e8d74b2f-86df-43b0-a9d9-72055a6b0432"

​
externalId
string
Example:

"my-payout-001"

​
status
enum<string>
Available options:
CREATED,
COMPLETED,
FAILED,
ERROR,
REFUNDED,
CASH_IN_CREATED,
CASH_IN_REQUEST,
CASH_IN_REQUESTED,
CASH_IN_PENDING,
CASH_IN_PROCESSING,
CASH_IN_COMPLETED,
CASH_IN_CANCELED,
CASH_IN_REJECTED,
CASH_IN_FAILED,
CASH_IN_ERROR,
KYT_OUT_CREATE,
KYT_OUT_PENDING,
KYT_OUT_PROCESSING,
KYT_OUT_COMPLETED,
KYT_OUT_FAILED,
CASH_OUT_CREATE,
CASH_OUT_CREATED,
CASH_OUT_REQUEST,
CASH_OUT_REQUESTED,
CASH_OUT_PENDING,
CASH_OUT_PENDING_FILE,
CASH_OUT_PROCESSING,
CASH_OUT_COMPLETED,
CASH_OUT_CANCELED,
CASH_OUT_FAILED,
CASH_OUT_ERROR,
REFUND_CREATE,
REFUND_CREATED,
REFUND_REQUEST,
REFUND_REQUESTED,
REFUND_PENDING,
REFUND_PROCESSING,
REFUND_COMPLETED,
REFUND_FAILED
Example:

"COMPLETED"

Response

​
payouts
object[]
required
​
totalPage
number
required
Example:

5