---
title: "Create a Funds Confirmation Request"
method: POST
path: "/funds-confirmations"
tags: ["Funds Confirmations"]
---

# Create a Funds Confirmation Request

`POST /funds-confirmations`

Enables a CBPII to check whether a PSU has sufficient available funds for a CBPII transaction.

## Headers

- `x-fapi-auth-date` string
- `x-fapi-customer-ip-address` string
- `x-fapi-interaction-id` string
- `Authorization` string, required
- `x-customer-user-agent` string
- `x-client-id` string

## Request body

- OBFundsConfirmation1
  - `Data` object, required
    - `ConsentId` string, required — Unique identification as assigned by the ASPSP to uniquely identify the funds confirmation consent resource.
    - `Reference` string, required — Unique reference, as assigned by the CBPII, to unambiguously refer to the request related to the payment transaction.
    - `InstructedAmount` object, required — Amount of money to be confirmed as available funds in the debtor account. Contains an Amount and a Currency.
      - `Amount` string, required — A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
      - `Currency` string, required — A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217 "Codes for the representation of currencies and funds".

## Response `201`

Funds Confirmation Created

- OBFundsConfirmationResponse1
  - `Data` object, required
    - `FundsConfirmationId` string, required — Unique identification as assigned by the ASPSP to uniquely identify the funds confirmation resource.
    - `ConsentId` string, required — Unique identification as assigned by the ASPSP to uniquely identify the funds confirmation consent resource.
    - `CreationDateTime` string, date-time, required — Date and time at which the resource was created. All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
    - `FundsAvailable` boolean, required — Flag to indicate the result of a confirmation of funds check.
    - `Reference` string, required — Unique reference, as assigned by the CBPII, to unambiguously refer to the request related to the payment transaction.
    - `InstructedAmount` object, required — Amount of money to be confirmed as available funds in the debtor account. Contains an Amount and a Currency.
      - `Amount` string, required — A number of monetary units specified in an active currency where the unit of currency is explicit and compliant with ISO 4217.
      - `Currency` string, required — A code allocated to a currency by a Maintenance Agency under an international identification scheme, as described in the latest edition of the international standard ISO 4217 "Codes for the representation of currencies and funds".
  - `Links` Links — Links relevant to the payload
    - `Self` string, uri, required
    - `First` string, uri
    - `Prev` string, uri
    - `Next` string, uri
    - `Last` string, uri
  - `Meta` Meta — Meta Data relevant to the payload
    - `TotalPages` integer
    - `FirstAvailableDateTime` string, date-time — All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00
    - `LastAvailableDateTime` string, date-time — All dates in the JSON payloads are represented in ISO 8601 date-time format. All date-time fields in responses must include the timezone. An example is below: 2017-04-05T10:43:07+00:00

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `405` — Method Not Allowed
- `406` — Not Acceptable
- `415` — Unsupported Media Type
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/openbankinguk/apis/confirmation-of-funds-api-specification.md) · [All operations](https://skmtc.net/openbankinguk/apis/confirmation-of-funds-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openbankinguk/confirmation-of-funds-api-specification/revisions/b9822eeed1d2/schema)