---
title: "Get Funding"
method: GET
path: "/v1/fundings/{fundingId}"
tags: ["Funding"]
---

# Get Funding

`GET /v1/fundings/{fundingId}`

## Request

- Base URL: `https://api.sandbox.velopayments.com`
- URL: `https://api.sandbox.velopayments.com/v1/fundings/{fundingId}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.sandbox.velopayments.com/v1/login`

Get Funding by Id

## Path parameters

- `fundingId` string, uuid, required

## Response `200`

Funding response

- FundingResponse
  - `fundingId` string, uuid, required
  - `payorId` string, uuid, required
  - `createdAt` string, date-time, required: The date and time the funding was created
  - `detectedFundingRef` string
  - `amount` integer, required
  - `currency` string, required: Valid ISO 4217 3 letter currency code. See the <a href="https://www.iso.org/iso-4217-currency-codes.html" target="_blank" a>ISO specification</a> for details.
  - `text` string
  - `physicalAccountName` string
  - `sourceAccountId` string, uuid
  - `allocationType` string: Funding Allocation Type. One of the following values: AUTOMATIC, MANUAL
  - `allocatedAt` string, date-time: Populated only if the funding has been allocated. The date and time the funding was allocated.
  - `allocationDate` string, date-time: Populated with allocatedAt if allocated otherwise createdAt. Deprecated in v2.36 - will be removed in the future.
  - `reason` string
  - `hiddenDate` string, date-time
  - `fundingAccountType` string, required: Funding Account Type. One of the following values: FBO, PRIVATE
  - `status` string, required: Current status of the funding. One of the follwing values: PENDING, UNALLOCATED, ALLOCATED, HIDDEN, RETURNED, RETURNING, BULK_RETURN, OTHER

## Other responses

- `400`: Invalid request. See Error message payload for details of failure
- `401`: Invalid access token. May be expired or invalid
- `403`: The authentication does not have permissions to access the resource This usually occurs when there is a valid authentication instance (client or user) but they do not have the required permissions
- `404`: The resource was not found or is no longer available

## Changes

- **2023-10-10** `b924ba134e09`: 1 breaking, 3 info
  - the response property `allocationDate` became optional for the status `200`
  - added the optional property `allocatedAt` to the response with the `200` status
  - response property `allocationDate` deprecated
  - added the required property `createdAt` to the response with the `200` status
- **2022-12-20** `27443d5dc998`: 2 info
  - api tag `Funding` added
  - api tag `Funding Manager` removed
- **2022-12-19** `25a3d8f6e24a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/changes/v1/fundings/:fundingId/get.md)

---

[API](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis.md) - [All operations](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/revisions/05c3f09fc50a?raw)