DFS v26.1
Loading
API docs by Redocly

DFS Funding Services API (latest)

Download OpenAPI specification:

Contains functionality around Funding Services.

For endpoints that support localization the language can be passed either as a query string parameter (using the name 'language') or in the 'accept-language' header.
If no language is passed to such endpoints then the default configured language will be used.

FundingManagement

Delete funding

Deletes (logically) a funding.

Authorizations:
Bearer
path Parameters
contactId
required
integer <int32>

The id of the contact.

fundingId
required
integer <int32>

The id of the funding.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Get funding by id

Gets a funding.

Authorizations:
Bearer
path Parameters
contactId
required
integer <int32>

The id of the contact.

fundingId
required
integer <int32>

The id of the funding.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "targetAccountUId": "3471b71d-e1fe-4648-a90e-43b6db21e973",
  • "sourceAccountUId": "f2c1f931-cd20-4268-a185-7ed11a7443a7",
  • "currencyUId": "2f87cc20-5347-43ea-a083-3122f16cbdb0",
  • "goalUId": "d691adea-b291-447b-83fe-6857f3a75f70",
  • "cronExpression": "0 0 6 ? * MON",
  • "id": 8,
  • "typeId": 1,
  • "targetAccountId": 2,
  • "sourceAccountId": 1,
  • "amount": 250,
  • "currencyId": 2,
  • "isActive": true,
  • "createDate": "2022-10-21T06:31:09",
  • "endDate": "2025-10-20T06:31:09",
  • "firstExecutionDate": "2022-10-31T06:31:09",
  • "goalId": 16,
  • "recurrenceTypeId": 2,
  • "isLockedForProcessing": false
}

Modify funding

Update existing funding.

Authorizations:
Bearer
path Parameters
contactId
required
integer <int32>

The id of the contact.

fundingId
required
integer <int32>

The id of the funding.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

Properties of the funding to update.

typeId
integer or null <int32>
amount
number or null <double>
createDate
string or null <date-time>
endDate
string or null <date-time>
firstExecutionDate
string or null <date-time>
recurrenceTypeId
integer or null <int32>
attributes
string or null

Responses

Request samples

Content type
{
  • "typeId": 2,
  • "amount": 5001,
  • "createDate": "2020-02-28T00:00:00",
  • "endDate": "2021-03-05T00:00:00",
  • "firstExecutionDate": "2021-03-05T00:00:00",
  • "recurrenceTypeId": 3,
  • "attributes": "{ \"Description\" : \"Recurring\" }"
}

Response samples

Content type
application/json
{
  • "id": 62,
  • "typeId": 2,
  • "targetAccountId": 1,
  • "sourceAccountId": 2,
  • "amount": 5001,
  • "currencyId": 2,
  • "isActive": true,
  • "createDate": "2020-02-28T00:00:00",
  • "endDate": "2021-03-05T00:00:00",
  • "firstExecutionDate": "2021-03-05T00:00:00",
  • "goalId": 12,
  • "recurrenceTypeId": 3,
  • "isLockedForProcessing": false,
  • "scheduledJobId": "12345",
  • "attributes": "{ \"Description\" : \"Recurring\" }"
}

Create funding

Creates a funding.

Authorizations:
Bearer
path Parameters
contactId
required
integer <int32>

The id of the contact.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

New funding.

fundingTypeId
integer or null <int32>
targetAccountId
integer or null <int32>
sourceAccountId
integer or null <int32>
amount
number or null <double>
currencyId
integer or null <int32>
isActive
boolean or null
createDate
string or null <date-time>
endDate
string or null <date-time>
firstExecutionDate
string or null <date-time>
goalId
integer or null <int32>
recurrenceTypeId
integer or null <int32>
isLockedForProcessing
boolean or null
attributes
string or null

Responses

Request samples

Content type
{
  • "fundingTypeId": 1,
  • "targetAccountId": 1,
  • "sourceAccountId": 2,
  • "amount": 1337,
  • "currencyId": 2,
  • "isActive": true,
  • "createDate": "2021-02-28T00:00:00",
  • "endDate": "2021-03-05T00:00:00",
  • "firstExecutionDate": "2021-03-05T00:00:00",
  • "goalId": 12,
  • "recurrenceTypeId": 2,
  • "isLockedForProcessing": false,
  • "attributes": "{ \"Description\" : \"(Test) Top up\" }"
}

Response samples

Content type
application/json
{
  • "id": 7,
  • "typeId": 1,
  • "targetAccountId": 1,
  • "sourceAccountId": 2,
  • "amount": 1337,
  • "currencyId": 2,
  • "isActive": true,
  • "createDate": "2021-02-28T00:00:00",
  • "endDate": "2021-03-05T00:00:00",
  • "firstExecutionDate": "2021-03-05T00:00:00",
  • "goalId": 12,
  • "recurrenceTypeId": 2,
  • "isLockedForProcessing": false,
  • "scheduledJobId": "12345",
  • "attributes": "{ \"Description\" : \"(Test) Top up\" }"
}

FundingSearch

Search fundings for a contact

Allows the User to search for Fundings of an authenticated Contact for a given set of criteria.

Authorizations:
Bearer
path Parameters
contactId
required
integer <int32>

The id of the contact.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The search parameters.

page
integer <int32>
pageSize
integer <int32>
typeIds
Array of integers or null <int32> [ items <int32 > ]
targetAccountIds
Array of integers or null <int32> [ items <int32 > ]
sourceAccountIds
Array of integers or null <int32> [ items <int32 > ]
goalIds
Array of integers or null <int32> [ items <int32 > ]
recurrenceTypeIds
Array of integers or null <int32> [ items <int32 > ]
isActive
boolean or null
scheduledJobIds
Array of strings or null

Responses

Request samples

Content type
{
  • "page": 1,
  • "pageSize": 3,
  • "typeIds": [
    ],
  • "targetAccountIds": [
    ],
  • "sourceAccountIds": [
    ],
  • "goalIds": [
    ],
  • "recurrenceTypeIds": [
    ],
  • "isActive": true,
  • "scheduledJobIds": [
    ]
}

Response samples

Content type
application/json
{
  • "fundings": [
    ],
  • "totalNumberOfResults": 1
}

Search fundings

Searches for fundings and returns a list with fundings (and key attributes) matching the passed request parameters.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

The request DTO

page
integer <int32>
pageSize
integer <int32>
sortBy
string or null
sortOrder
string (SortOrder)
Enum: "Ascending" "Descending"
ids
Array of integers or null <int32> [ items <int32 > ]
typeIds
Array of integers or null <int32> [ items <int32 > ]
targetAccountIds
Array of integers or null <int32> [ items <int32 > ]
sourceAccountIds
Array of integers or null <int32> [ items <int32 > ]
currencyIds
Array of integers or null <int32> [ items <int32 > ]
goalIds
Array of integers or null <int32> [ items <int32 > ]
recurrenceTypeIds
Array of integers or null <int32> [ items <int32 > ]
isActive
boolean or null
isLockedForProcessing
boolean or null
scheduledJobIds
Array of strings or null
createDateFrom
string or null <date-time>
createDateTo
string or null <date-time>
firstExecutionDateFrom
string or null <date-time>
firstExecutionDateTo
string or null <date-time>
nextExecutionDateFrom
string or null <date-time>
nextExecutionDateTo
string or null <date-time>
endDateFrom
string or null <date-time>
endDateTo
string or null <date-time>

Responses

Request samples

Content type
{
  • "isActive": true,
  • "isLockedForProcessing": false,
  • "sortBy": "id",
  • "sortOrder": "Ascending",
  • "page": 1,
  • "pageSize": 10
}

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "page": 1,
  • "pageSize": 10,
  • "pageCount": 1,
  • "totalCount": 2
}