---
title: "View validation errors for a Settlement"
method: GET
path: "/v3.0/{ClientId}/payins/intents/settlements/{SettlementId}/validations"
tags: ["Settlements"]
---

# View validation errors for a Settlement

`GET /v3.0/{ClientId}/payins/intents/settlements/{SettlementId}/validations`

Retrieve information about failed or partially matched settlements.

If your Settlement's `Status` is `PARTIALLY_MATCHED` or `FAILED`, this endpoint returns information about the errors in your CSV file's footer or transaction lines.

## Path parameters

- `ClientId` string, required
- `SettlementId` string, required

## Query parameters

- `page` integer
- `per_page` integer

## Headers

- `Authorization` string, required

## Response `200`

Success

- ViewValidationErrorsForASettlementResponse
  - `FooterErrors` ViewValidationErrorsForASettlementResponseFooterErrorsItems[] — The errors encountered in the CSV footer.
    - `FooterName` string — The footer line which produced the error.
    - `Code` string — **Returned values:** `TOTAL_NET_MISCALCULATED`, `FEES_TOTAL_MISMATCH`, `FORMAT_DATE_INVALID`, `PROVIDER_NAME_MISSING`, `CURRENCY_MISMATCH` The type of error encountered. - `TOTAL_NET_MISCALCULATED` – Arithmetic check failed. The calculated net amount does not match the file's stated amount. `FooterName`: `TotalNetSettlementAmount`. - `FEES_TOTAL_MISMATCH` – The footer value does not equal the sum of all `ExternalProviderFees` found in the transaction lines. `FooterName`: `TotalSettlementFeesAmount`. - `FORMAT_DATE_INVALID` – Date format is invalid or empty. Expected: DD-MM-YYYY. `FooterName`: `SettlementDate`. - `PROVIDER_NAME_MISSING` – The mandatory `ExternalProviderName` field is empty. `FooterName`: `ExternalProviderName`. - `CURRENCY_MISMATCH` – Currency code provided is not a valid ISO 4217 code or does not match line item currencies. `FooterName`: `SettlementCurrency`.
    - `Description` string — A description of the error.
  - `LinesErrors` ViewValidationErrorsForASettlementResponseLinesErrorsItems[] — The errors encountered in the CSV's transaction lines.
    - `ExternalProviderReference` string — The unique identifier of the transaction at the provider level.
    - `ExternalTransactionType` string — Response values: `PAYMENT`, `REFUND`, `DISPUTE` The type of the transaction.
    - `Details` ViewValidationErrorsForASettlementResponseLinesErrorsItemsDetailsItems[] — The validation errors for this transaction line.
      - `Code` string — **Returned values:** `MATCH_REF_NOT_FOUND`, `INTENT_WRONG_STATUS`, `AMOUNT_MISMATCH`, `MANDATORY_MISSING`, `FORMAT_DATE_INVALID` The type of error encountered. - `MATCH_REF_NOT_FOUND` – `ExternalProviderReference` not found for any existing Intent in the system, possibly triggered by an intent not created in Echo, a reference mismatch, or a wrong environment. - `INTENT_WRONG_STATUS` – Intent associated with this transaction is not in a reconcilable state (e.g., `AUTHORIZED` or `CANCELED`), possibly triggered by an intent already settled, cancelled, or not captured. - `AMOUNT_MISMATCH` – File amount does not match the Intent's captured amount, possibly triggered by a currency conversion issue, a partial settlement, or a fee calculation error. - `MANDATORY_MISSING` – A required field is empty or missing, possibly triggered by incomplete PSP data or a file format issue. - `FORMAT_DATE_INVALID` – A date field has an invalid format (expected DD-MM-YYYY), possibly triggered by an incorrect date format or a timezone issue.
      - `Description` string — A description of the error.

## Changes

- **2026-07-26** `795281070285` — 2 warning, 3 info
  - removed the optional property `LinesErrors/items/Code` from the response with the `200` status
  - removed the optional property `LinesErrors/items/Description` from the response with the `200` status
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `per_page`
  - …1 more

[Change history](https://skmtc.dev/mangopay/apis/api-reference/changes/v3.0/:ClientId/payins/intents/settlements/:SettlementId/validations/get.md)

---

[API](https://skmtc.dev/mangopay/apis/api-reference.md) · [All operations](https://skmtc.dev/mangopay/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mangopay/api-reference/revisions/956211a94070/schema)