Upload CSV for bulk payouts

POST

https://api.jokoor.com/v1/payouts/recipients/send-bulk/upload-csv

Last modified:2025-12-28 04:38:46

Maintainer:Not configured

OperationId:uploadBulkPayoutCSV

Upload a CSV file containing recipient payout data. The CSV will be validated and stored for processing.

CSV Format:

recipient_id,amount,description
rec_abc123,500.00,Monthly payment
rec_def456,750.00,Bonus payment

Requirements:

Maximum file size: 5MB

Maximum 1000 rows

Required columns: recipient_id, amount

Optional column: description

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params multipart/form-dataRequired

Responses

🟢200OK

application/json

CSV uploaded and validated

Body

🟠400Bad Request

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.jokoor.com/v1/payouts/recipients/send-bulk/upload-csv' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""'

Response Example

{
    "data": {
        "upload_id": "upload_xyz789",
        "rows_count": 45,
        "total_amount": "22500.00",
        "validation_errors": [
            {
                "row": 5,
                "field": "amount",
                "error": "Invalid amount format"
            }
        ],
        "expires_at": "2019-08-24T14:15:22.123Z"
    }
}

Modified at 2025-12-28 04:38:46

Get bulk payout batch status

Process uploaded CSV bulk payouts