---
title: "Submit a CSV repayment report for downstream processing."
method: POST
path: "/BulkPayments/report"
tags: ["BulkPayments"]
---

# Submit a CSV repayment report for downstream processing.

`POST /BulkPayments/report`

## Request

- Base URL: `https://partners.staging-youlendapi.com/loan`
- URL: `https://partners.staging-youlendapi.com/loan/BulkPayments/report`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://youlend-stag.eu.auth0.com/oauth/token`

The request must be sent as multipart/form-data with required metadata and file fields.<br />
The metadata field is plain text whose value must be valid JSON.<br />
Metadata fields and CSV fields use camelCase names.<br />
Additional CSV columns are allowed and ignored by this endpoint.<br />
When validation fails, the response body contains grouped top-level and row-level errors.<br />
Sample metadata:
{
    "reportId": "report-1",
    "transferId": "transfer-1",
    "currency": "GBP",
    "transferDate": "2024-01-01"
}
Sample CSV body:
loan_id,payments_transmitted
11111111-1111-1111-1111-111111111111,123.45

## Headers

- `api-version` string

## Request body `multipart/form-data`

- object
  - `Metadata` BulkPaymentsReportMetadataModel: JSON metadata part submitted with a CSV repayment report.<br /> Metadata properties use camelCase names.<br /> Send a plain text form field containing JSON such as<br /><remarks> Sample metadata: { "reportId": "report-1", "transferId": "transfer-1", "currency": "GBP", "transferDate": "2026-05-22" } </remarks>
    - `reportId` string, nullable: Gets or sets the unique report identifier.
    - `currency` string, nullable: Gets or sets the currency for all payments in the report.
    - `transferId` string, nullable: Gets or sets the transfer identifier for the repayment report.
    - `transferDate` string, date-time, nullable: Gets or sets the optional transfer date sent by the partner as a date without time.
  - `File` string, binary, nullable: Gets or sets the required CSV file containing repayment rows. The required headers are loan_id and payments_transmitted, and additional columns are ignored.

## Response `200`

CSV repayment report accepted for processing.

## Other responses

- `400`: The request payload is invalid.
- `401`: Unauthorized request! Please check your bearer token.

---

[API](https://skmtc.dev/youlend/apis/third-party-loan-api.md) - [All operations](https://skmtc.dev/youlend/apis/third-party-loan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/youlend/apis/third-party-loan-api/revisions/2336031a2fcf?raw)