backbone-partner-api

http://app.backbone-software.com
Backbone Software developer guide

Backbone Software is an end to end software solution for lending. It manages the complete lifecycle of borrowers, applications and loan accounts. Using the Backbone API, you can manage borrower accounts, application and payments.

The loan creation flow is as follows:

  1. Create products
  2. Create an end user (borrower)
  3. Create and update an application for an end user
  4. Create loan account for approved application and specific product
  5. Disburse funds and collect

Making a request to the Backbone API requires an API key. The key should be provided by Backbone. The request header must include a X-Api-Key header with the API provided.

Operations
products
GET /api/v1/products/product/
POST /api/v1/products/product/
GET /api/v1/products/product/{id}/
PUT /api/v1/products/product/{id}/
PATCH /api/v1/products/product/{id}/
DELETE /api/v1/products/product/{id}/
POST /api/v1/products/product/{id}/publish/
Supported products - How they work

The Backbone platform support the following products:

  • Revolving credit

Revolving Credit

Revolving credit allows you provide a line of credit to the end users that renews on monthly basis. With this product, each month, a statement will be generated, describing the transactions that were applied during the statement period, the closing balance of the period and the minimum payment the end user is required to pay. The end user is then expected to repay at least the minimum repayment by the due date. If not paid by the due date the account becomes late. When configuring a Revolving Credit product, you need to

  • specify how the minimum repyment is calculated
  • specify the day in the month in which the statement is created
  • specify the day in the month the repayment is due by
  • specify the number of days between the account becoming late and the account becomes in arrears
Get a list of available products
GET /api/v1/products/product/

Authentication

api_key

Get a list of available products

Request parameters

limit
integer optional

Number of results to return per page.

offset
integer optional

The initial index from which to return the results.

Responses

200 200

200

Create a product
POST /api/v1/products/product/

Authentication

api_key

Create a product

Request body

application/json
Object
type
string

The type of product you are trying to configure. Allowed values are: revolving_credit

max_loan_amount
number

The upper limit of the credit amount for loan acounts that are created for this product

default_loan_amount
number

A default amount to be used in case an amount is not provided when creating a loan account

max_interest_rate
number

Max Interest rate for loan acounts that are created for this product, should be expressed in % not real number i.e. for 5% annual rate you should provide 5 and not 0.05

default_interest_rate
number

A default interest to be used in case the rate is not provided when creating a loan account, should be expressed in % not real number i.e. for 5% annual rate you should provide 5 and not 0.05

name
string required

A readable name for easy recognition of the product

installments
integer

(Releveant only for term loans) The default numebr of instalments to be used in case the the number of instalments is not provided when creating a loan account

default_grace_instalments
integer

(Releveant only for term loans) Grace instalments are the number of instalments in which repayment is not expected to be repaid

principal_repayment_grace
integer

(Releveant only for term loans) Grace instalments are the number of instalments in which principal repayment is not expected to be repaid

default_fees

A list of pre-configured fees which can be used on loan account.

arrears_tolerance
integer

The number of days between account becoming late and account becoming in arrears

interest_calculation
string

There are two types of schedule calculation (we need to add a field for that): Equal principal payments - With this option we take the principal amount and divide by the number of instalments to get the principal repayment of each instalments. We then calculate the interest accrued between instalments based on the principal balance in the account after the instalments.

Even total payments - With this option all the repayments are of the same amount (except the last one sometimes when you have to round the principal amount).

early_repayment_recalculation
string

Releveant only for term loans

repayment_holiday_scheduling
string

Should the repayment date be rescheduled due to it being a holiday. Options are:

  • “last_business_day_before_the_day” - Moves the repayment date to the last business day before the repayment date
  • “first_business_day_after_the_day” - Moves the repayment date to the first business day after the repayment date
  • “on_day” - Do not reschedule the repayment date
calculate_interest_on_holidays
boolean
  • “True” means that the interest will be calculated on holidays
  • “Flase” means that on holidays, the interest will not be calculated
repayment_date_type
string

Options are:

  • “day_of_month” - Repayment date is on specific day of the month
  • “last_day_of_month” - Last business day of the month
  • “first_day_of_month” - First business day of the month
repayment_date_period
integer

If repayment_date_type is day_of_month then this field specifies the day

custom_field
string

Responses

201 201

201

Default Fees

This schema describes a Default Fee. Default fees can be used for quick application of fees on a loan account.

Object
name
string

Readable name for the fee

Example:
"Disbursement Fee"
type
string

Describes whether the fee should be calculated as flat fee or as percetage from the account balance.

Enumeration:
flat

For this type of fee, the figure in the amount field will be used to calculate the fee

percent

This type of fee is calculated as percentage of the account balance. The figure in the amount field represents that percentage.

Amount
number

This field represents the amount of the fee or the percentage of the current balance to be calculated as the amount of the fee.

Event
string

On which event this fee should be applied for

Enumeration:
disbursement

Select this event if you wish that the fee will be automatically applied upon disbursement event

arrears

Select this event if you wish that the fee will be automatically applied upon the account going into arrears

default

Select this event if you wish that the fee will be automatically applied upon the account going into default

manual

Select this event if this fee will be applied using ad hoc API commands

Get a specific product configuration
GET /api/v1/products/product/{id}/

Authentication

api_key

Get a specific product configuration

Path variables

id
string required

A UUID string identifying this Product.

Responses

200 200

200

Update the configuration of a specific product
PUT /api/v1/products/product/{id}/

Authentication

api_key

Update the configuration of a specific product

Path variables

id
string required

A UUID string identifying this Product.

Request body

application/json
Object
type
string

The type of product you are trying to configure. Allowed values are: revolving_credit

max_loan_amount
number

The upper limit of the credit amount for loan acounts that are created for this product

default_loan_amount
number

A default amount to be used in case an amount is not provided when creating a loan account

max_interest_rate
number

Max Interest rate in % not real number i.e. 5% and not 0.05

default_interest_rate
number

Default Interest rate in % not real number i.e. 5% and not 0.05, if not not specified when creating the loan account

name
string required

A readable name for easy recognition of the product

installments
integer

(Releveant only for term loans) The default numebr of instalments to be used in case the the number of instalments is not provided when creating a loan account

default_grace_instalments
integer

(Releveant only for term loans) Grace instalments are the number of instalments in which repayment is not expected to be repaid

principal_repayment_grace
integer

(Releveant only for term loans) Grace instalments are the number of instalments in which principal repayment is not expected to be repaid

default_fees
string

A list of pre-configured fees which can be used on loan account. The structure of a fee is: { ‘name’: Readable name for the fee, ‘type’: use flat charge the amount in the “amount” field as a fixed amount, or percent to charge an amount a percentage, as configured in the “amount” field, from the account balance, ‘amount’: the amount of the fee in % or flat according to the “type” field, ‘event’: ‘arrears’, }

arrears_tolerance
integer

The number of days between account becoming late and account becoming in arrears

interest_calculation
string

There are two types of schedule calculation (we need to add a field for that): Equal principal payments - With this option we take the principal amount and divide by the number of instalments to get the principal repayment of each instalments. We then calculate the interest accrued between instalments based on the principal balance in the account after the instalments.

Even total payments - With this option all the repayments are of the same amount (except the last one sometimes when you have to round the principal amount).

early_repayment_recalculation
string

(Releveant only for term loans) We have two option for how to reschedule the repayments in the event of an early repayment: from_last_instalment - Choosing this option means that the amount repaid is taken off the principal of the last repayment. If the amount repaid is higher then the principal of the last repayment, then it should be deducted from the instalment before that, and so on, effectively reducing the number of instalments in the loan while all the remaining repayments stay the same in principal and interest amounts.

reduced_instalments - Choosing this option mean that the overall number of instalments stays the same, but the amount of each instalment is reduced. When calculating the new schedule, we need to take the total principal owed and recalculate the amounts for each of the remaining instalment as if it’s a new loan taken nor for that number of instalments.

repayment_holiday_scheduling
string

Should the repayment date be rescheduled due to it being a holiday. Options are: “last_business_day_before_the_day” - Moves the repayment date to the last business day before the repayment date

“first_business_day_after_the_day” - Moves the repayment date to the first business day after the repayment date

“on_day” - Do not reschedule the repayment date

calculate_interest_on_holidays
boolean

“True” means that the interest will be calculated on holidays

“Flase” means that on holidays, the interest will not be calculated

repayment_date_type
string

Options are: “day_of_month” - Repayment date is on specific day of the month

“last_day_of_month” - Last business day of the month

“first_day_of_month” - First business day of the month

repayment_date_period
integer

If repayment_date_type is day_of_month then this field specifies the day

custom_field
string

Responses

200 200

200

Update the configuration of a specific product
PATCH /api/v1/products/product/{id}/

Authentication

api_key

Update the configuration of a specific product

Path variables

id
string required

A UUID string identifying this Product.

Request body

application/json
Object
type
string

The type of product you are trying to configure. Allowed values are: revolving_credit

max_loan_amount
number

The upper limit of the credit amount for loan acounts that are created for this product

default_loan_amount
number

A default amount to be used in case an amount is not provided when creating a loan account

max_interest_rate
number

Max Interest rate in % not real number i.e. 5% and not 0.05

default_interest_rate
number

Default Interest rate in % not real number i.e. 5% and not 0.05, if not not specified when creating the loan account

name
string

A readable name for easy recognition of the product

installments
integer

(Releveant only for term loans) The default numebr of instalments to be used in case the the number of instalments is not provided when creating a loan account

default_grace_instalments
integer

(Releveant only for term loans) Grace instalments are the number of instalments in which repayment is not expected to be repaid

principal_repayment_grace
integer

(Releveant only for term loans) Grace instalments are the number of instalments in which principal repayment is not expected to be repaid

default_fees
string

A list of pre-configured fees which can be used on loan account. The structure of a fee is: { ‘name’: Readable name for the fee, ‘type’: use flat charge the amount in the “amount” field as a fixed amount, or percent to charge an amount a percentage, as configured in the “amount” field, from the account balance, ‘amount’: the amount of the fee in % or flat according to the “type” field, ‘event’: ‘arrears’, }

arrears_tolerance
integer

The number of days between account becoming late and account becoming in arrears

interest_calculation
string

There are two types of schedule calculation (we need to add a field for that): Equal principal payments - With this option we take the principal amount and divide by the number of instalments to get the principal repayment of each instalments. We then calculate the interest accrued between instalments based on the principal balance in the account after the instalments.

Even total payments - With this option all the repayments are of the same amount (except the last one sometimes when you have to round the principal amount).

early_repayment_recalculation
string

(Releveant only for term loans) We have two option for how to reschedule the repayments in the event of an early repayment: from_last_instalment - Choosing this option means that the amount repaid is taken off the principal of the last repayment. If the amount repaid is higher then the principal of the last repayment, then it should be deducted from the instalment before that, and so on, effectively reducing the number of instalments in the loan while all the remaining repayments stay the same in principal and interest amounts.

reduced_instalments - Choosing this option mean that the overall number of instalments stays the same, but the amount of each instalment is reduced. When calculating the new schedule, we need to take the total principal owed and recalculate the amounts for each of the remaining instalment as if it’s a new loan taken nor for that number of instalments.

repayment_holiday_scheduling
string

Should the repayment date be rescheduled due to it being a holiday. Options are: “last_business_day_before_the_day” - Moves the repayment date to the last business day before the repayment date

“first_business_day_after_the_day” - Moves the repayment date to the first business day after the repayment date

“on_day” - Do not reschedule the repayment date

calculate_interest_on_holidays
boolean

“True” means that the interest will be calculated on holidays

“Flase” means that on holidays, the interest will not be calculated

repayment_date_type
string

Options are: “day_of_month” - Repayment date is on specific day of the month

“last_day_of_month” - Last business day of the month

“first_day_of_month” - First business day of the month

repayment_date_period
integer

If repayment_date_type is day_of_month then this field specifies the day

custom_field
string

Responses

200 200

200

Delete the configuration of a specific product
DELETE /api/v1/products/product/{id}/

Authentication

api_key

Delete the configuration of a specific product Once a product is published it cannot be deleted

Path variables

id
string required

A UUID string identifying this Product.

Responses

204 204

204

Publish a configured product
POST /api/v1/products/product/{id}/publish/

Authentication

api_key

Publish a configured product. Once a product is published it cannot be updated

Path variables

id
string required

A UUID string identifying this Product.

Request body

application/json
Object
type
string

The type of product you are trying to configure. Allowed values are: revolving_credit

max_loan_amount
number

The upper limit of the credit amount for loan acounts that are created for this product

default_loan_amount
number

A default amount to be used in case an amount is not provided when creating a loan account

max_interest_rate
number

Max Interest rate in % not real number i.e. 5% and not 0.05

default_interest_rate
number

Default Interest rate in % not real number i.e. 5% and not 0.05, if not not specified when creating the loan account

name
string required

A readable name for easy recognition of the product

installments
integer

(Releveant only for term loans) The default numebr of instalments to be used in case the the number of instalments is not provided when creating a loan account

default_grace_instalments
integer

(Releveant only for term loans) Grace instalments are the number of instalments in which repayment is not expected to be repaid

principal_repayment_grace
integer

(Releveant only for term loans) Grace instalments are the number of instalments in which principal repayment is not expected to be repaid

default_fees
string

A list of pre-configured fees which can be used on loan account. The structure of a fee is: { ‘name’: Readable name for the fee, ‘type’: use flat charge the amount in the “amount” field as a fixed amount, or percent to charge an amount a percentage, as configured in the “amount” field, from the account balance, ‘amount’: the amount of the fee in % or flat according to the “type” field, ‘event’: ‘arrears’, }

arrears_tolerance
integer

The number of days between account becoming late and account becoming in arrears

interest_calculation
string

There are two types of schedule calculation (we need to add a field for that): Equal principal payments - With this option we take the principal amount and divide by the number of instalments to get the principal repayment of each instalments. We then calculate the interest accrued between instalments based on the principal balance in the account after the instalments.

Even total payments - With this option all the repayments are of the same amount (except the last one sometimes when you have to round the principal amount).

early_repayment_recalculation
string

(Releveant only for term loans) We have two option for how to reschedule the repayments in the event of an early repayment: from_last_instalment - Choosing this option means that the amount repaid is taken off the principal of the last repayment. If the amount repaid is higher then the principal of the last repayment, then it should be deducted from the instalment before that, and so on, effectively reducing the number of instalments in the loan while all the remaining repayments stay the same in principal and interest amounts.

reduced_instalments - Choosing this option mean that the overall number of instalments stays the same, but the amount of each instalment is reduced. When calculating the new schedule, we need to take the total principal owed and recalculate the amounts for each of the remaining instalment as if it’s a new loan taken nor for that number of instalments.

repayment_holiday_scheduling
string

Should the repayment date be rescheduled due to it being a holiday. Options are: “last_business_day_before_the_day” - Moves the repayment date to the last business day before the repayment date

“first_business_day_after_the_day” - Moves the repayment date to the first business day after the repayment date

“on_day” - Do not reschedule the repayment date

calculate_interest_on_holidays
boolean

“True” means that the interest will be calculated on holidays

“Flase” means that on holidays, the interest will not be calculated

repayment_date_type
string

Options are: “day_of_month” - Repayment date is on specific day of the month

“last_day_of_month” - Last business day of the month

“first_day_of_month” - First business day of the month

repayment_date_period
integer

If repayment_date_type is day_of_month then this field specifies the day

custom_field
string

Responses

201 201

201

endusers

These operation are used to manage the lifecycle of an end user (borrower). The end user account can be updated all the time. When an application is completed and being processed, Backbone will use the most current details it has on the end user.

GET /api/v1/endusers/enduser/
POST /api/v1/endusers/enduser/
GET /api/v1/endusers/enduser/{id}/
PUT /api/v1/endusers/enduser/{id}/
PATCH /api/v1/endusers/enduser/{id}/
Get filtered list of end users
GET /api/v1/endusers/enduser/

Authentication

api_key

View set for managing end user account

Request parameters

limit
integer optional

Number of results to return per page.

offset
integer optional

The initial index from which to return the results.

id
string optional
created
string optional
updated
string optional
first_name
string optional
last_name
string optional
birth_date
string optional
address_line_1
string optional
address_line_2
string optional
address_line_3
string optional
city
string optional
postal_code
string optional
country
string optional
bank_account_number
string optional
sort_code
string optional
mobile_number
string optional
email
string optional

Responses

200 200

200

Create an enduser
POST /api/v1/endusers/enduser/

Authentication

api_key

View set for managing end user account

Request body

application/json
Object
first_name
string required
last_name
string required
birth_date
string required
address_line_1
string required
address_line_2
string required
address_line_3
string
city
string required
postal_code
string required
country
string
bank_account_number
string required
sort_code
string required
mobile_number
string
email
string

Responses

201 201

201

Get specific end user
GET /api/v1/endusers/enduser/{id}/

Authentication

api_key

View set for managing end user account

Path variables

id
string required

A UUID string identifying this end user.

Responses

200 200

200

Update a specific end user
PUT /api/v1/endusers/enduser/{id}/

Authentication

api_key

View set for managing end user account

Path variables

id
string required

A UUID string identifying this end user.

Request body

application/json
Object
first_name
string required
last_name
string required
birth_date
string required
address_line_1
string required
address_line_2
string required
address_line_3
string
city
string required
postal_code
string required
country
string
bank_account_number
string required
sort_code
string required
mobile_number
string
email
string

Responses

200 200

200

Update specific end user
PATCH /api/v1/endusers/enduser/{id}/

Authentication

api_key

View set for managing end user account

Path variables

id
string required

A UUID string identifying this end user.

Request body

application/json
Object
first_name
string
last_name
string
birth_date
string
address_line_1
string
address_line_2
string
address_line_3
string
city
string
postal_code
string
country
string
bank_account_number
string
sort_code
string
mobile_number
string
email
string

Responses

200 200

200

applications

These operations are used to manage the life cycle of an application. Application can be created for an end user to apply for a specific credit product. After its creation, the end user can’t be changed. The rest of the application data can be updated. Once the application is complete, the “/complete/” request must be issued to trigger the processing of the application.

As long as there isn’t a loan account attached to the application, it can be reopened, updated and withdrawan. Once a loan account is opened for the application it becomes immutable.

POST /api/v1/applications/application/
GET /api/v1/applications/application/{id}/
GET /api/v1/applications/application/
PUT /api/v1/applications/application/{id}/
PATCH /api/v1/applications/application/{id}/
POST /api/v1/applications/application/{id}/complete/
POST /api/v1/applications/application/{id}/reopen/
POST /api/v1/applications/application/{id}/withdraw/
Create a new application
POST /api/v1/applications/application/

Authentication

api_key

This endpoint is used to create a new application

Request body

application/json
Object
product
string required

Product ID of the product the end user is applying for

end_user
string required

End user ID of the user applying for the product

amount
number required

Amount of credit requested. If not present, then the product default amount will be used.

installments
integer

Number of requested instalments (Relevant only for term loans). If not present, then the product default amount will be used.

rate
number required

Specific interest for the end user. If not present, then the product default amount will be used.

custom_field
string

Json structure of additional custom fields

Responses

201 201

201

Get specific application
GET /api/v1/applications/application/{id}/

Authentication

api_key

This endpoint is used to retrieve specific application

Path variables

id
string required

A UUID string identifying this application.

Responses

200 200

200

Get a filtered list of applications
GET /api/v1/applications/application/

Authentication

api_key

This endpoint returns a list of application according to the filter used. By default returns 20 results, starting at offset 0.

Request parameters

limit
integer optional

Number of results to return per page.

offset
integer optional

The initial index from which to return the results.

id
string optional

Application ID

id__iexact
string optional
id__contains
string optional
id__icontains
string optional
id__in
string optional

Multiple values may be separated by commas.

created
string optional
created__lt
string optional
created__lte
string optional
created__gt
string optional
created__gte
string optional
created__in
string optional

Multiple values may be separated by commas.

created__year
number optional
created__year__lt
number optional
created__year__lte
number optional
created__year__gt
number optional
created__year__gte
number optional
created__year__in
number optional

Multiple values may be separated by commas.

created__month
number optional
created__month__lt
number optional
created__month__lte
number optional
created__month__gt
number optional
created__month__gte
number optional
created__month__in
number optional

Multiple values may be separated by commas.

created__day
number optional
created__day__lt
number optional
created__day__lte
number optional
created__day__gt
number optional
created__day__gte
number optional
created__day__in
number optional

Multiple values may be separated by commas.

updated
string optional
updated__lt
string optional
updated__lte
string optional
updated__gt
string optional
updated__gte
string optional
updated__in
string optional

Multiple values may be separated by commas.

updated__year
number optional
updated__year__lt
number optional
updated__year__lte
number optional
updated__year__gt
number optional
updated__year__gte
number optional
updated__year__in
number optional

Multiple values may be separated by commas.

updated__month
number optional
updated__month__lt
number optional
updated__month__lte
number optional
updated__month__gt
number optional
updated__month__gte
number optional
updated__month__in
number optional

Multiple values may be separated by commas.

updated__day
number optional
updated__day__lt
number optional
updated__day__lte
number optional
updated__day__gt
number optional
updated__day__gte
number optional
updated__day__in
number optional

Multiple values may be separated by commas.

status
string optional
status__iexact
string optional
status__contains
string optional
status__icontains
string optional
status__in
string optional

Multiple values may be separated by commas.

product
string optional
product__lt
string optional
product__lte
string optional
product__gt
string optional
product__gte
string optional
product__in
string optional

Multiple values may be separated by commas.

end_user
string optional
end_user__lt
string optional
end_user__lte
string optional
end_user__gt
string optional
end_user__gte
string optional
end_user__in
string optional

Multiple values may be separated by commas.

amount
number optional
amount__lt
number optional
amount__lte
number optional
amount__gt
number optional
amount__gte
number optional
amount__in
number optional

Multiple values may be separated by commas.

installments
number optional
installments__lt
number optional
installments__lte
number optional
installments__gt
number optional
installments__gte
number optional
installments__in
number optional

Multiple values may be separated by commas.

rate
number optional
rate__lt
number optional
rate__lte
number optional
rate__gt
number optional
rate__gte
number optional
rate__in
number optional

Multiple values may be separated by commas.

reason
string optional
reason__iexact
string optional
reason__contains
string optional
reason__icontains
string optional
reason__in
string optional

Multiple values may be separated by commas.

processing_finished_at
string optional
processing_finished_at__lt
string optional
processing_finished_at__lte
string optional
processing_finished_at__gt
string optional
processing_finished_at__gte
string optional
processing_finished_at__in
string optional

Multiple values may be separated by commas.

processing_finished_at__year
number optional
processing_finished_at__year__lt
number optional
processing_finished_at__year__lte
number optional
processing_finished_at__year__gt
number optional
processing_finished_at__year__gte
number optional
processing_finished_at__year__in
number optional

Multiple values may be separated by commas.

processing_finished_at__month
number optional
processing_finished_at__month__lt
number optional
processing_finished_at__month__lte
number optional
processing_finished_at__month__gt
number optional
processing_finished_at__month__gte
number optional
processing_finished_at__month__in
number optional

Multiple values may be separated by commas.

processing_finished_at__day
number optional
processing_finished_at__day__lt
number optional
processing_finished_at__day__lte
number optional
processing_finished_at__day__gt
number optional
processing_finished_at__day__gte
number optional
processing_finished_at__day__in
number optional

Multiple values may be separated by commas.

end_user__id
string optional
end_user__id__iexact
string optional
end_user__id__contains
string optional
end_user__id__icontains
string optional
end_user__id__in
string optional

Multiple values may be separated by commas.

end_user__created
string optional
end_user__created__lt
string optional
end_user__created__lte
string optional
end_user__created__gt
string optional
end_user__created__gte
string optional
end_user__created__in
string optional

Multiple values may be separated by commas.

end_user__created__year
number optional
end_user__created__year__lt
number optional
end_user__created__year__lte
number optional
end_user__created__year__gt
number optional
end_user__created__year__gte
number optional
end_user__created__year__in
number optional

Multiple values may be separated by commas.

end_user__created__month
number optional
end_user__created__month__lt
number optional
end_user__created__month__lte
number optional
end_user__created__month__gt
number optional
end_user__created__month__gte
number optional
end_user__created__month__in
number optional

Multiple values may be separated by commas.

end_user__created__day
number optional
end_user__created__day__lt
number optional
end_user__created__day__lte
number optional
end_user__created__day__gt
number optional
end_user__created__day__gte
number optional
end_user__created__day__in
number optional

Multiple values may be separated by commas.

end_user__updated
string optional
end_user__updated__lt
string optional
end_user__updated__lte
string optional
end_user__updated__gt
string optional
end_user__updated__gte
string optional
end_user__updated__in
string optional

Multiple values may be separated by commas.

end_user__updated__year
number optional
end_user__updated__year__lt
number optional
end_user__updated__year__lte
number optional
end_user__updated__year__gt
number optional
end_user__updated__year__gte
number optional
end_user__updated__year__in
number optional

Multiple values may be separated by commas.

end_user__updated__month
number optional
end_user__updated__month__lt
number optional
end_user__updated__month__lte
number optional
end_user__updated__month__gt
number optional
end_user__updated__month__gte
number optional
end_user__updated__month__in
number optional

Multiple values may be separated by commas.

end_user__updated__day
number optional
end_user__updated__day__lt
number optional
end_user__updated__day__lte
number optional
end_user__updated__day__gt
number optional
end_user__updated__day__gte
number optional
end_user__updated__day__in
number optional

Multiple values may be separated by commas.

end_user__first_name
string optional
end_user__first_name__iexact
string optional
end_user__first_name__contains
string optional
end_user__first_name__icontains
string optional
end_user__first_name__in
string optional

Multiple values may be separated by commas.

end_user__last_name
string optional
end_user__last_name__iexact
string optional
end_user__last_name__contains
string optional
end_user__last_name__icontains
string optional
end_user__last_name__in
string optional

Multiple values may be separated by commas.

end_user__birth_date
string optional
end_user__birth_date__lt
string optional
end_user__birth_date__lte
string optional
end_user__birth_date__gt
string optional
end_user__birth_date__gte
string optional
end_user__birth_date__in
string optional

Multiple values may be separated by commas.

end_user__birth_date__year
number optional
end_user__birth_date__year__lt
number optional
end_user__birth_date__year__lte
number optional
end_user__birth_date__year__gt
number optional
end_user__birth_date__year__gte
number optional
end_user__birth_date__year__in
number optional

Multiple values may be separated by commas.

end_user__birth_date__month
number optional
end_user__birth_date__month__lt
number optional
end_user__birth_date__month__lte
number optional
end_user__birth_date__month__gt
number optional
end_user__birth_date__month__gte
number optional
end_user__birth_date__month__in
number optional

Multiple values may be separated by commas.

end_user__birth_date__day
number optional
end_user__birth_date__day__lt
number optional
end_user__birth_date__day__lte
number optional
end_user__birth_date__day__gt
number optional
end_user__birth_date__day__gte
number optional
end_user__birth_date__day__in
number optional

Multiple values may be separated by commas.

end_user__address_line_1
string optional
end_user__address_line_1__iexact
string optional
end_user__address_line_1__contains
string optional
end_user__address_line_1__icontains
string optional
end_user__address_line_1__in
string optional

Multiple values may be separated by commas.

end_user__address_line_2
string optional
end_user__address_line_2__iexact
string optional
end_user__address_line_2__contains
string optional
end_user__address_line_2__icontains
string optional
end_user__address_line_2__in
string optional

Multiple values may be separated by commas.

end_user__address_line_3
string optional
end_user__address_line_3__iexact
string optional
end_user__address_line_3__contains
string optional
end_user__address_line_3__icontains
string optional
end_user__address_line_3__in
string optional

Multiple values may be separated by commas.

end_user__city
string optional
end_user__city__iexact
string optional
end_user__city__contains
string optional
end_user__city__icontains
string optional
end_user__city__in
string optional

Multiple values may be separated by commas.

end_user__postal_code
string optional
end_user__postal_code__iexact
string optional
end_user__postal_code__contains
string optional
end_user__postal_code__icontains
string optional
end_user__postal_code__in
string optional

Multiple values may be separated by commas.

end_user__country
string optional
end_user__country__iexact
string optional
end_user__country__contains
string optional
end_user__country__icontains
string optional
end_user__country__in
string optional

Multiple values may be separated by commas.

end_user__bank_account_number
string optional
end_user__bank_account_number__iexact
string optional
end_user__bank_account_number__contains
string optional
end_user__bank_account_number__icontains
string optional
end_user__bank_account_number__in
string optional

Multiple values may be separated by commas.

end_user__sort_code
string optional
end_user__sort_code__iexact
string optional
end_user__sort_code__contains
string optional
end_user__sort_code__icontains
string optional
end_user__sort_code__in
string optional

Multiple values may be separated by commas.

end_user__mobile_number
string optional
end_user__mobile_number__iexact
string optional
end_user__mobile_number__contains
string optional
end_user__mobile_number__icontains
string optional
end_user__mobile_number__in
string optional

Multiple values may be separated by commas.

end_user__email
string optional
end_user__email__iexact
string optional
end_user__email__contains
string optional
end_user__email__icontains
string optional
end_user__email__in
string optional

Multiple values may be separated by commas.

Responses

200 200

200

Update a specific application
PUT /api/v1/applications/application/{id}/

Authentication

api_key

View set for manipulation with applications.

Path variables

id
string required

A UUID string identifying this application.

Request body

application/json
Object
product
string required
end_user
string required
amount
number required
installments
integer

Number of instalments

rate
number required

Interest rate in % not real number i.e. 5% and not 0.05

custom_field
string

Responses

200 200

200

Update a specific application
PATCH /api/v1/applications/application/{id}/

Authentication

api_key

View set for manipulation with applications.

Path variables

id
string required

A UUID string identifying this application.

Request body

application/json
Object
product
string
end_user
string
amount
number
installments
integer

Number of instalments

rate
number

Interest rate in % not real number i.e. 5% and not 0.05

custom_field
string

Responses

200 200

200

Set application status to complete
POST /api/v1/applications/application/{id}/complete/

Authentication

api_key

This endpoint sets the status of application with ID {id} to complete. This will trigger the processing of the application which results in a “accept”/“decline” decision

Path variables

id
string required

A UUID string identifying this application.

Request body

application/json
Object
product
string required
end_user
string required
amount
number required
installments
integer

Number of instalments

rate
number required

Interest rate in % not real number i.e. 5% and not 0.05

custom_field
string

Responses

201 201

201

Reopen application
POST /api/v1/applications/application/{id}/reopen/

Authentication

api_key

Sets the status of the application to “incomplete”. This request is only applicable when:

  • Application is withdrawen
  • Application was processed and a decision given

This reuqest is invalid when a loan account was already created for this application.

Path variables

id
string required

A UUID string identifying this application.

Request body

application/json
Object
product
string required
end_user
string required
amount
number required
installments
integer

Number of instalments

rate
number required

Interest rate in % not real number i.e. 5% and not 0.05

custom_field
string

Responses

201 201

201

Set application status to withdrawan
POST /api/v1/applications/application/{id}/withdraw/

Authentication

api_key

This requets will set the application status to withdrawan. This request is only applicable when:

  • Application is incomplete
  • Application was processed and a decision given

This reuqest is invalid when a loan account was already created for this application.

Path variables

id
string required

A UUID string identifying this application.

Request body

application/json
Object
product
string required
end_user
string required
amount
number required
installments
integer

Number of instalments

rate
number required

Interest rate in % not real number i.e. 5% and not 0.05

custom_field
string

Responses

201 201

201

loans
GET /api/v1/loans/loan/
POST /api/v1/loans/loan/
GET /api/v1/loans/loan/{id}/
POST /api/v1/loans/loan/{id}/close/
POST /api/v1/loans/loan/{id}/make_arrears/
POST /api/v1/loans/loan/{id}/make_default/
POST /api/v1/loans/loan/{id}/stop_interest_calculation/
POST /api/v1/loans/loan/{id}/start_interest_calculation/
Get a filtered list of loan accounts
GET /api/v1/loans/loan/

Authentication

api_key

This endpoint returns a list of application according to the filter used. By default returns 20 results, starting at offset 0.

Request parameters

limit
integer optional

Number of results to return per page.

offset
integer optional

The initial index from which to return the results.

id
string optional
id__iexact
string optional
id__contains
string optional
id__icontains
string optional
id__in
string optional

Multiple values may be separated by commas.

created
string optional
created__lt
string optional
created__lte
string optional
created__gt
string optional
created__gte
string optional
created__in
string optional

Multiple values may be separated by commas.

created__year
number optional
created__year__lt
number optional
created__year__lte
number optional
created__year__gt
number optional
created__year__gte
number optional
created__year__in
number optional

Multiple values may be separated by commas.

created__month
number optional
created__month__lt
number optional
created__month__lte
number optional
created__month__gt
number optional
created__month__gte
number optional
created__month__in
number optional

Multiple values may be separated by commas.

created__day
number optional
created__day__lt
number optional
created__day__lte
number optional
created__day__gt
number optional
created__day__gte
number optional
created__day__in
number optional

Multiple values may be separated by commas.

updated
string optional
updated__lt
string optional
updated__lte
string optional
updated__gt
string optional
updated__gte
string optional
updated__in
string optional

Multiple values may be separated by commas.

updated__year
number optional
updated__year__lt
number optional
updated__year__lte
number optional
updated__year__gt
number optional
updated__year__gte
number optional
updated__year__in
number optional

Multiple values may be separated by commas.

updated__month
number optional
updated__month__lt
number optional
updated__month__lte
number optional
updated__month__gt
number optional
updated__month__gte
number optional
updated__month__in
number optional

Multiple values may be separated by commas.

updated__day
number optional
updated__day__lt
number optional
updated__day__lte
number optional
updated__day__gt
number optional
updated__day__gte
number optional
updated__day__in
number optional

Multiple values may be separated by commas.

application
string optional
application__lt
string optional
application__lte
string optional
application__gt
string optional
application__gte
string optional
application__in
string optional

Multiple values may be separated by commas.

end_user
string optional
end_user__lt
string optional
end_user__lte
string optional
end_user__gt
string optional
end_user__gte
string optional
end_user__in
string optional

Multiple values may be separated by commas.

amount
number optional
amount__lt
number optional
amount__lte
number optional
amount__gt
number optional
amount__gte
number optional
amount__in
number optional

Multiple values may be separated by commas.

interest_rate
number optional
interest_rate__lt
number optional
interest_rate__lte
number optional
interest_rate__gt
number optional
interest_rate__gte
number optional
interest_rate__in
number optional

Multiple values may be separated by commas.

installments
number optional
installments__lt
number optional
installments__lte
number optional
installments__gt
number optional
installments__gte
number optional
installments__in
number optional

Multiple values may be separated by commas.

grace_instalments
number optional
grace_instalments__lt
number optional
grace_instalments__lte
number optional
grace_instalments__gt
number optional
grace_instalments__gte
number optional
grace_instalments__in
number optional

Multiple values may be separated by commas.

principal_repayment_grace
number optional
principal_repayment_grace__lt
number optional
principal_repayment_grace__lte
number optional
principal_repayment_grace__gt
number optional
principal_repayment_grace__gte
number optional
principal_repayment_grace__in
number optional

Multiple values may be separated by commas.

arrears_tolerance
number optional
arrears_tolerance__lt
number optional
arrears_tolerance__lte
number optional
arrears_tolerance__gt
number optional
arrears_tolerance__gte
number optional
arrears_tolerance__in
number optional

Multiple values may be separated by commas.

status
string optional
status__iexact
string optional
status__contains
string optional
status__icontains
string optional
status__in
string optional

Multiple values may be separated by commas.

principal
number optional
principal__lt
number optional
principal__lte
number optional
principal__gt
number optional
principal__gte
number optional
principal__in
number optional

Multiple values may be separated by commas.

interest
number optional
interest__lt
number optional
interest__lte
number optional
interest__gt
number optional
interest__gte
number optional
interest__in
number optional

Multiple values may be separated by commas.

fee
number optional
fee__lt
number optional
fee__lte
number optional
fee__gt
number optional
fee__gte
number optional
fee__in
number optional

Multiple values may be separated by commas.

pending_principal
number optional
pending_principal__lt
number optional
pending_principal__lte
number optional
pending_principal__gt
number optional
pending_principal__gte
number optional
pending_principal__in
number optional

Multiple values may be separated by commas.

pending_interest
number optional
pending_interest__lt
number optional
pending_interest__lte
number optional
pending_interest__gt
number optional
pending_interest__gte
number optional
pending_interest__in
number optional

Multiple values may be separated by commas.

pending_fee
number optional
pending_fee__lt
number optional
pending_fee__lte
number optional
pending_fee__gt
number optional
pending_fee__gte
number optional
pending_fee__in
number optional

Multiple values may be separated by commas.

last_transaction
string optional
last_transaction__lt
string optional
last_transaction__lte
string optional
last_transaction__gt
string optional
last_transaction__gte
string optional
last_transaction__in
string optional

Multiple values may be separated by commas.

close_substatus
string optional
close_substatus__iexact
string optional
close_substatus__contains
string optional
close_substatus__icontains
string optional
close_substatus__in
string optional

Multiple values may be separated by commas.

close_reason
string optional
close_reason__iexact
string optional
close_reason__contains
string optional
close_reason__icontains
string optional
close_reason__in
string optional

Multiple values may be separated by commas.

business_days_in_period
number optional
business_days_in_period__lt
number optional
business_days_in_period__lte
number optional
business_days_in_period__gt
number optional
business_days_in_period__gte
number optional
business_days_in_period__in
number optional

Multiple values may be separated by commas.

end_user__id
string optional
end_user__id__iexact
string optional
end_user__id__contains
string optional
end_user__id__icontains
string optional
end_user__id__in
string optional

Multiple values may be separated by commas.

end_user__created
string optional
end_user__created__lt
string optional
end_user__created__lte
string optional
end_user__created__gt
string optional
end_user__created__gte
string optional
end_user__created__in
string optional

Multiple values may be separated by commas.

end_user__created__year
number optional
end_user__created__year__lt
number optional
end_user__created__year__lte
number optional
end_user__created__year__gt
number optional
end_user__created__year__gte
number optional
end_user__created__year__in
number optional

Multiple values may be separated by commas.

end_user__created__month
number optional
end_user__created__month__lt
number optional
end_user__created__month__lte
number optional
end_user__created__month__gt
number optional
end_user__created__month__gte
number optional
end_user__created__month__in
number optional

Multiple values may be separated by commas.

end_user__created__day
number optional
end_user__created__day__lt
number optional
end_user__created__day__lte
number optional
end_user__created__day__gt
number optional
end_user__created__day__gte
number optional
end_user__created__day__in
number optional

Multiple values may be separated by commas.

end_user__updated
string optional
end_user__updated__lt
string optional
end_user__updated__lte
string optional
end_user__updated__gt
string optional
end_user__updated__gte
string optional
end_user__updated__in
string optional

Multiple values may be separated by commas.

end_user__updated__year
number optional
end_user__updated__year__lt
number optional
end_user__updated__year__lte
number optional
end_user__updated__year__gt
number optional
end_user__updated__year__gte
number optional
end_user__updated__year__in
number optional

Multiple values may be separated by commas.

end_user__updated__month
number optional
end_user__updated__month__lt
number optional
end_user__updated__month__lte
number optional
end_user__updated__month__gt
number optional
end_user__updated__month__gte
number optional
end_user__updated__month__in
number optional

Multiple values may be separated by commas.

end_user__updated__day
number optional
end_user__updated__day__lt
number optional
end_user__updated__day__lte
number optional
end_user__updated__day__gt
number optional
end_user__updated__day__gte
number optional
end_user__updated__day__in
number optional

Multiple values may be separated by commas.

end_user__first_name
string optional
end_user__first_name__iexact
string optional
end_user__first_name__contains
string optional
end_user__first_name__icontains
string optional
end_user__first_name__in
string optional

Multiple values may be separated by commas.

end_user__last_name
string optional
end_user__last_name__iexact
string optional
end_user__last_name__contains
string optional
end_user__last_name__icontains
string optional
end_user__last_name__in
string optional

Multiple values may be separated by commas.

end_user__birth_date
string optional
end_user__birth_date__lt
string optional
end_user__birth_date__lte
string optional
end_user__birth_date__gt
string optional
end_user__birth_date__gte
string optional
end_user__birth_date__in
string optional

Multiple values may be separated by commas.

end_user__birth_date__year
number optional
end_user__birth_date__year__lt
number optional
end_user__birth_date__year__lte
number optional
end_user__birth_date__year__gt
number optional
end_user__birth_date__year__gte
number optional
end_user__birth_date__year__in
number optional

Multiple values may be separated by commas.

end_user__birth_date__month
number optional
end_user__birth_date__month__lt
number optional
end_user__birth_date__month__lte
number optional
end_user__birth_date__month__gt
number optional
end_user__birth_date__month__gte
number optional
end_user__birth_date__month__in
number optional

Multiple values may be separated by commas.

end_user__birth_date__day
number optional
end_user__birth_date__day__lt
number optional
end_user__birth_date__day__lte
number optional
end_user__birth_date__day__gt
number optional
end_user__birth_date__day__gte
number optional
end_user__birth_date__day__in
number optional

Multiple values may be separated by commas.

end_user__address_line_1
string optional
end_user__address_line_1__iexact
string optional
end_user__address_line_1__contains
string optional
end_user__address_line_1__icontains
string optional
end_user__address_line_1__in
string optional

Multiple values may be separated by commas.

end_user__address_line_2
string optional
end_user__address_line_2__iexact
string optional
end_user__address_line_2__contains
string optional
end_user__address_line_2__icontains
string optional
end_user__address_line_2__in
string optional

Multiple values may be separated by commas.

end_user__address_line_3
string optional
end_user__address_line_3__iexact
string optional
end_user__address_line_3__contains
string optional
end_user__address_line_3__icontains
string optional
end_user__address_line_3__in
string optional

Multiple values may be separated by commas.

end_user__city
string optional
end_user__city__iexact
string optional
end_user__city__contains
string optional
end_user__city__icontains
string optional
end_user__city__in
string optional

Multiple values may be separated by commas.

end_user__postal_code
string optional
end_user__postal_code__iexact
string optional
end_user__postal_code__contains
string optional
end_user__postal_code__icontains
string optional
end_user__postal_code__in
string optional

Multiple values may be separated by commas.

end_user__country
string optional
end_user__country__iexact
string optional
end_user__country__contains
string optional
end_user__country__icontains
string optional
end_user__country__in
string optional

Multiple values may be separated by commas.

end_user__bank_account_number
string optional
end_user__bank_account_number__iexact
string optional
end_user__bank_account_number__contains
string optional
end_user__bank_account_number__icontains
string optional
end_user__bank_account_number__in
string optional

Multiple values may be separated by commas.

end_user__sort_code
string optional
end_user__sort_code__iexact
string optional
end_user__sort_code__contains
string optional
end_user__sort_code__icontains
string optional
end_user__sort_code__in
string optional

Multiple values may be separated by commas.

end_user__mobile_number
string optional
end_user__mobile_number__iexact
string optional
end_user__mobile_number__contains
string optional
end_user__mobile_number__icontains
string optional
end_user__mobile_number__in
string optional

Multiple values may be separated by commas.

end_user__email
string optional
end_user__email__iexact
string optional
end_user__email__contains
string optional
end_user__email__icontains
string optional
end_user__email__in
string optional

Multiple values may be separated by commas.

application__id
string optional
application__id__iexact
string optional
application__id__contains
string optional
application__id__icontains
string optional
application__id__in
string optional

Multiple values may be separated by commas.

application__created
string optional
application__created__lt
string optional
application__created__lte
string optional
application__created__gt
string optional
application__created__gte
string optional
application__created__in
string optional

Multiple values may be separated by commas.

application__created__year
number optional
application__created__year__lt
number optional
application__created__year__lte
number optional
application__created__year__gt
number optional
application__created__year__gte
number optional
application__created__year__in
number optional

Multiple values may be separated by commas.

application__created__month
number optional
application__created__month__lt
number optional
application__created__month__lte
number optional
application__created__month__gt
number optional
application__created__month__gte
number optional
application__created__month__in
number optional

Multiple values may be separated by commas.

application__created__day
number optional
application__created__day__lt
number optional
application__created__day__lte
number optional
application__created__day__gt
number optional
application__created__day__gte
number optional
application__created__day__in
number optional

Multiple values may be separated by commas.

application__updated
string optional
application__updated__lt
string optional
application__updated__lte
string optional
application__updated__gt
string optional
application__updated__gte
string optional
application__updated__in
string optional

Multiple values may be separated by commas.

application__updated__year
number optional
application__updated__year__lt
number optional
application__updated__year__lte
number optional
application__updated__year__gt
number optional
application__updated__year__gte
number optional
application__updated__year__in
number optional

Multiple values may be separated by commas.

application__updated__month
number optional
application__updated__month__lt
number optional
application__updated__month__lte
number optional
application__updated__month__gt
number optional
application__updated__month__gte
number optional
application__updated__month__in
number optional

Multiple values may be separated by commas.

application__updated__day
number optional
application__updated__day__lt
number optional
application__updated__day__lte
number optional
application__updated__day__gt
number optional
application__updated__day__gte
number optional
application__updated__day__in
number optional

Multiple values may be separated by commas.

application__status
string optional
application__status__iexact
string optional
application__status__contains
string optional
application__status__icontains
string optional
application__status__in
string optional

Multiple values may be separated by commas.

application__product
string optional
application__product__lt
string optional
application__product__lte
string optional
application__product__gt
string optional
application__product__gte
string optional
application__product__in
string optional

Multiple values may be separated by commas.

application__end_user
string optional
application__end_user__lt
string optional
application__end_user__lte
string optional
application__end_user__gt
string optional
application__end_user__gte
string optional
application__end_user__in
string optional

Multiple values may be separated by commas.

application__amount
number optional
application__amount__lt
number optional
application__amount__lte
number optional
application__amount__gt
number optional
application__amount__gte
number optional
application__amount__in
number optional

Multiple values may be separated by commas.

application__installments
number optional
application__installments__lt
number optional
application__installments__lte
number optional
application__installments__gt
number optional
application__installments__gte
number optional
application__installments__in
number optional

Multiple values may be separated by commas.

application__rate
number optional
application__rate__lt
number optional
application__rate__lte
number optional
application__rate__gt
number optional
application__rate__gte
number optional
application__rate__in
number optional

Multiple values may be separated by commas.

application__reason
string optional
application__reason__iexact
string optional
application__reason__contains
string optional
application__reason__icontains
string optional
application__reason__in
string optional

Multiple values may be separated by commas.

application__processing_finished_at
string optional
application__processing_finished_at__lt
string optional
application__processing_finished_at__lte
string optional
application__processing_finished_at__gt
string optional
application__processing_finished_at__gte
string optional
application__processing_finished_at__in
string optional

Multiple values may be separated by commas.

application__processing_finished_at__year
number optional
application__processing_finished_at__year__lt
number optional
application__processing_finished_at__year__lte
number optional
application__processing_finished_at__year__gt
number optional
application__processing_finished_at__year__gte
number optional
application__processing_finished_at__year__in
number optional

Multiple values may be separated by commas.

application__processing_finished_at__month
number optional
application__processing_finished_at__month__lt
number optional
application__processing_finished_at__month__lte
number optional
application__processing_finished_at__month__gt
number optional
application__processing_finished_at__month__gte
number optional
application__processing_finished_at__month__in
number optional

Multiple values may be separated by commas.

application__processing_finished_at__day
number optional
application__processing_finished_at__day__lt
number optional
application__processing_finished_at__day__lte
number optional
application__processing_finished_at__day__gt
number optional
application__processing_finished_at__day__gte
number optional
application__processing_finished_at__day__in
number optional

Multiple values may be separated by commas.

Responses

200 200

200

Create a new loan account
POST /api/v1/loans/loan/

Authentication

api_key

This endpoint is used to create a new loan account.

Request body

application/json
Object
application
string required
custom_field
string

Responses

201 201

201

Get a specific loan account
GET /api/v1/loans/loan/{id}/

Authentication

api_key

This endpoint is used to get a specific loan account with ID {id}

Path variables

id
string required

A UUID string identifying this Loan account.

Responses

200 200

200

Close a specific loan account
POST /api/v1/loans/loan/{id}/close/

Authentication

api_key

This endpoint is used to close a loan account. Once an account is closed, it stops accruing interest, and the outstanding balance is considered as loss.

Path variables

id
string required

A UUID string identifying this Loan account.

Request body

application/json
Object
close_reason
string required

A string with a readable closing reason

close_substatus
string required

The valid substatuses are paid_in_full or written_off

Responses

201 201

201

Set loan account status to "in arrears"
POST /api/v1/loans/loan/{id}/make_arrears/

Authentication

api_key

This endpoint is used to manually set the account status to arrears. Loan accounts go into arrears when a repayment is late for more then the period specified in the arrears tolerance field.

Path variables

id
string required

A UUID string identifying this Loan account.

Request body

application/json
Object
application
string required
custom_field
string

Responses

201 201

201

Set loan account status to "default"
POST /api/v1/loans/loan/{id}/make_default/

Authentication

api_key

This endpoint is used to manually set the account status to default.

Path variables

id
string required

A UUID string identifying this Loan account.

Request body

application/json
Object
application
string required
custom_field
string

Responses

201 201

201

Disable interest calculation for a loan account
POST /api/v1/loans/loan/{id}/stop_interest_calculation/

Authentication

api_key

This request may be used in cases when a partner whishes to stop interest calculation for a loan. Using this request will stop the interest calcualtion for a loan, until it’s enabled again using Enable interest calculation for a loan account

Path variables

id
string required

A UUID string identifying this Loan account.

Request body

application/json
Object
application
string required
custom_field
string

Responses

201 201

201

Enable interest calculation for a loan account
POST /api/v1/loans/loan/{id}/start_interest_calculation/

Authentication

api_key

By default, interest is calculated for active loan accounts. In some scenarios, the partner may choose to disable interest calcualtion for a loan. In that use case, this request will enable it back.

Path variables

id
string required

A UUID string identifying this Loan account.

Request body

application/json
Object
application
string required
custom_field
string

Responses

201 201

201

transactions
GET /api/v1/transactions/transaction/
POST /api/v1/transactions/transaction/
GET /api/v1/transactions/transaction/{id}/
POST /api/v1/transactions/transaction/{id}/revert/
Get a filtered list of transactions
GET /api/v1/transactions/transaction/

Authentication

api_key

View set for managing transactions

Request parameters

limit
integer optional

Number of results to return per page.

offset
integer optional

The initial index from which to return the results.

id
string optional
id__iexact
string optional
id__contains
string optional
id__icontains
string optional
id__in
string optional

Multiple values may be separated by commas.

created
string optional
created__lt
string optional
created__lte
string optional
created__gt
string optional
created__gte
string optional
created__in
string optional

Multiple values may be separated by commas.

created__year
number optional
created__year__lt
number optional
created__year__lte
number optional
created__year__gt
number optional
created__year__gte
number optional
created__year__in
number optional

Multiple values may be separated by commas.

created__month
number optional
created__month__lt
number optional
created__month__lte
number optional
created__month__gt
number optional
created__month__gte
number optional
created__month__in
number optional

Multiple values may be separated by commas.

created__day
number optional
created__day__lt
number optional
created__day__lte
number optional
created__day__gt
number optional
created__day__gte
number optional
created__day__in
number optional

Multiple values may be separated by commas.

updated
string optional
updated__lt
string optional
updated__lte
string optional
updated__gt
string optional
updated__gte
string optional
updated__in
string optional

Multiple values may be separated by commas.

updated__year
number optional
updated__year__lt
number optional
updated__year__lte
number optional
updated__year__gt
number optional
updated__year__gte
number optional
updated__year__in
number optional

Multiple values may be separated by commas.

updated__month
number optional
updated__month__lt
number optional
updated__month__lte
number optional
updated__month__gt
number optional
updated__month__gte
number optional
updated__month__in
number optional

Multiple values may be separated by commas.

updated__day
number optional
updated__day__lt
number optional
updated__day__lte
number optional
updated__day__gt
number optional
updated__day__gte
number optional
updated__day__in
number optional

Multiple values may be separated by commas.

loan
string optional
loan__lt
string optional
loan__lte
string optional
loan__gt
string optional
loan__gte
string optional
loan__in
string optional

Multiple values may be separated by commas.

type
string optional
type__iexact
string optional
type__contains
string optional
type__icontains
string optional
type__in
string optional

Multiple values may be separated by commas.

amount
number optional
amount__lt
number optional
amount__lte
number optional
amount__gt
number optional
amount__gte
number optional
amount__in
number optional

Multiple values may be separated by commas.

status
string optional
status__iexact
string optional
status__contains
string optional
status__icontains
string optional
status__in
string optional

Multiple values may be separated by commas.

fee_name
string optional
fee_name__iexact
string optional
fee_name__contains
string optional
fee_name__icontains
string optional
fee_name__in
string optional

Multiple values may be separated by commas.

fee_type
string optional
fee_type__iexact
string optional
fee_type__contains
string optional
fee_type__icontains
string optional
fee_type__in
string optional

Multiple values may be separated by commas.

custom_fee_amount
number optional
custom_fee_amount__lt
number optional
custom_fee_amount__lte
number optional
custom_fee_amount__gt
number optional
custom_fee_amount__gte
number optional
custom_fee_amount__in
number optional

Multiple values may be separated by commas.

previous_transaction
string optional
previous_transaction__lt
string optional
previous_transaction__lte
string optional
previous_transaction__gt
string optional
previous_transaction__gte
string optional
previous_transaction__in
string optional

Multiple values may be separated by commas.

idempotency_key
string optional
idempotency_key__iexact
string optional
idempotency_key__contains
string optional
idempotency_key__icontains
string optional
idempotency_key__in
string optional

Multiple values may be separated by commas.

related_transaction
string optional
related_transaction__lt
string optional
related_transaction__lte
string optional
related_transaction__gt
string optional
related_transaction__gte
string optional
related_transaction__in
string optional

Multiple values may be separated by commas.

completed_at
string optional
completed_at__lt
string optional
completed_at__lte
string optional
completed_at__gt
string optional
completed_at__gte
string optional
completed_at__in
string optional

Multiple values may be separated by commas.

completed_at__year
number optional
completed_at__year__lt
number optional
completed_at__year__lte
number optional
completed_at__year__gt
number optional
completed_at__year__gte
number optional
completed_at__year__in
number optional

Multiple values may be separated by commas.

completed_at__month
number optional
completed_at__month__lt
number optional
completed_at__month__lte
number optional
completed_at__month__gt
number optional
completed_at__month__gte
number optional
completed_at__month__in
number optional

Multiple values may be separated by commas.

completed_at__day
number optional
completed_at__day__lt
number optional
completed_at__day__lte
number optional
completed_at__day__gt
number optional
completed_at__day__gte
number optional
completed_at__day__in
number optional

Multiple values may be separated by commas.

reverted_at
string optional
reverted_at__lt
string optional
reverted_at__lte
string optional
reverted_at__gt
string optional
reverted_at__gte
string optional
reverted_at__in
string optional

Multiple values may be separated by commas.

reverted_at__year
number optional
reverted_at__year__lt
number optional
reverted_at__year__lte
number optional
reverted_at__year__gt
number optional
reverted_at__year__gte
number optional
reverted_at__year__in
number optional

Multiple values may be separated by commas.

reverted_at__month
number optional
reverted_at__month__lt
number optional
reverted_at__month__lte
number optional
reverted_at__month__gt
number optional
reverted_at__month__gte
number optional
reverted_at__month__in
number optional

Multiple values may be separated by commas.

reverted_at__day
number optional
reverted_at__day__lt
number optional
reverted_at__day__lte
number optional
reverted_at__day__gt
number optional
reverted_at__day__gte
number optional
reverted_at__day__in
number optional

Multiple values may be separated by commas.

result_outstanding_balance
number optional
result_outstanding_balance__lt
number optional
result_outstanding_balance__lte
number optional
result_outstanding_balance__gt
number optional
result_outstanding_balance__gte
number optional
result_outstanding_balance__in
number optional

Multiple values may be separated by commas.

affected_loan_principal
number optional
affected_loan_principal__lt
number optional
affected_loan_principal__lte
number optional
affected_loan_principal__gt
number optional
affected_loan_principal__gte
number optional
affected_loan_principal__in
number optional

Multiple values may be separated by commas.

affected_loan_interest
number optional
affected_loan_interest__lt
number optional
affected_loan_interest__lte
number optional
affected_loan_interest__gt
number optional
affected_loan_interest__gte
number optional
affected_loan_interest__in
number optional

Multiple values may be separated by commas.

affected_loan_fee
number optional
affected_loan_fee__lt
number optional
affected_loan_fee__lte
number optional
affected_loan_fee__gt
number optional
affected_loan_fee__gte
number optional
affected_loan_fee__in
number optional

Multiple values may be separated by commas.

result_loan_status
string optional
result_loan_status__iexact
string optional
result_loan_status__contains
string optional
result_loan_status__icontains
string optional
result_loan_status__in
string optional

Multiple values may be separated by commas.

statement
string optional
statement__lt
string optional
statement__lte
string optional
statement__gt
string optional
statement__gte
string optional
statement__in
string optional

Multiple values may be separated by commas.

loan__id
string optional
loan__id__iexact
string optional
loan__id__contains
string optional
loan__id__icontains
string optional
loan__id__in
string optional

Multiple values may be separated by commas.

loan__created
string optional
loan__created__lt
string optional
loan__created__lte
string optional
loan__created__gt
string optional
loan__created__gte
string optional
loan__created__in
string optional

Multiple values may be separated by commas.

loan__created__year
number optional
loan__created__year__lt
number optional
loan__created__year__lte
number optional
loan__created__year__gt
number optional
loan__created__year__gte
number optional
loan__created__year__in
number optional

Multiple values may be separated by commas.

loan__created__month
number optional
loan__created__month__lt
number optional
loan__created__month__lte
number optional
loan__created__month__gt
number optional
loan__created__month__gte
number optional
loan__created__month__in
number optional

Multiple values may be separated by commas.

loan__created__day
number optional
loan__created__day__lt
number optional
loan__created__day__lte
number optional
loan__created__day__gt
number optional
loan__created__day__gte
number optional
loan__created__day__in
number optional

Multiple values may be separated by commas.

loan__updated
string optional
loan__updated__lt
string optional
loan__updated__lte
string optional
loan__updated__gt
string optional
loan__updated__gte
string optional
loan__updated__in
string optional

Multiple values may be separated by commas.

loan__updated__year
number optional
loan__updated__year__lt
number optional
loan__updated__year__lte
number optional
loan__updated__year__gt
number optional
loan__updated__year__gte
number optional
loan__updated__year__in
number optional

Multiple values may be separated by commas.

loan__updated__month
number optional
loan__updated__month__lt
number optional
loan__updated__month__lte
number optional
loan__updated__month__gt
number optional
loan__updated__month__gte
number optional
loan__updated__month__in
number optional

Multiple values may be separated by commas.

loan__updated__day
number optional
loan__updated__day__lt
number optional
loan__updated__day__lte
number optional
loan__updated__day__gt
number optional
loan__updated__day__gte
number optional
loan__updated__day__in
number optional

Multiple values may be separated by commas.

loan__application
string optional
loan__application__lt
string optional
loan__application__lte
string optional
loan__application__gt
string optional
loan__application__gte
string optional
loan__application__in
string optional

Multiple values may be separated by commas.

loan__end_user
string optional
loan__end_user__lt
string optional
loan__end_user__lte
string optional
loan__end_user__gt
string optional
loan__end_user__gte
string optional
loan__end_user__in
string optional

Multiple values may be separated by commas.

loan__amount
number optional
loan__amount__lt
number optional
loan__amount__lte
number optional
loan__amount__gt
number optional
loan__amount__gte
number optional
loan__amount__in
number optional

Multiple values may be separated by commas.

loan__interest_rate
number optional
loan__interest_rate__lt
number optional
loan__interest_rate__lte
number optional
loan__interest_rate__gt
number optional
loan__interest_rate__gte
number optional
loan__interest_rate__in
number optional

Multiple values may be separated by commas.

loan__installments
number optional
loan__installments__lt
number optional
loan__installments__lte
number optional
loan__installments__gt
number optional
loan__installments__gte
number optional
loan__installments__in
number optional

Multiple values may be separated by commas.

loan__grace_instalments
number optional
loan__grace_instalments__lt
number optional
loan__grace_instalments__lte
number optional
loan__grace_instalments__gt
number optional
loan__grace_instalments__gte
number optional
loan__grace_instalments__in
number optional

Multiple values may be separated by commas.

loan__principal_repayment_grace
number optional
loan__principal_repayment_grace__lt
number optional
loan__principal_repayment_grace__lte
number optional
loan__principal_repayment_grace__gt
number optional
loan__principal_repayment_grace__gte
number optional
loan__principal_repayment_grace__in
number optional

Multiple values may be separated by commas.

loan__arrears_tolerance
number optional
loan__arrears_tolerance__lt
number optional
loan__arrears_tolerance__lte
number optional
loan__arrears_tolerance__gt
number optional
loan__arrears_tolerance__gte
number optional
loan__arrears_tolerance__in
number optional

Multiple values may be separated by commas.

loan__status
string optional
loan__status__iexact
string optional
loan__status__contains
string optional
loan__status__icontains
string optional
loan__status__in
string optional

Multiple values may be separated by commas.

loan__principal
number optional
loan__principal__lt
number optional
loan__principal__lte
number optional
loan__principal__gt
number optional
loan__principal__gte
number optional
loan__principal__in
number optional

Multiple values may be separated by commas.

loan__interest
number optional
loan__interest__lt
number optional
loan__interest__lte
number optional
loan__interest__gt
number optional
loan__interest__gte
number optional
loan__interest__in
number optional

Multiple values may be separated by commas.

loan__fee
number optional
loan__fee__lt
number optional
loan__fee__lte
number optional
loan__fee__gt
number optional
loan__fee__gte
number optional
loan__fee__in
number optional

Multiple values may be separated by commas.

loan__pending_principal
number optional
loan__pending_principal__lt
number optional
loan__pending_principal__lte
number optional
loan__pending_principal__gt
number optional
loan__pending_principal__gte
number optional
loan__pending_principal__in
number optional

Multiple values may be separated by commas.

loan__pending_interest
number optional
loan__pending_interest__lt
number optional
loan__pending_interest__lte
number optional
loan__pending_interest__gt
number optional
loan__pending_interest__gte
number optional
loan__pending_interest__in
number optional

Multiple values may be separated by commas.

loan__pending_fee
number optional
loan__pending_fee__lt
number optional
loan__pending_fee__lte
number optional
loan__pending_fee__gt
number optional
loan__pending_fee__gte
number optional
loan__pending_fee__in
number optional

Multiple values may be separated by commas.

loan__last_transaction
string optional
loan__last_transaction__lt
string optional
loan__last_transaction__lte
string optional
loan__last_transaction__gt
string optional
loan__last_transaction__gte
string optional
loan__last_transaction__in
string optional

Multiple values may be separated by commas.

loan__close_substatus
string optional
loan__close_substatus__iexact
string optional
loan__close_substatus__contains
string optional
loan__close_substatus__icontains
string optional
loan__close_substatus__in
string optional

Multiple values may be separated by commas.

loan__close_reason
string optional
loan__close_reason__iexact
string optional
loan__close_reason__contains
string optional
loan__close_reason__icontains
string optional
loan__close_reason__in
string optional

Multiple values may be separated by commas.

loan__business_days_in_period
number optional
loan__business_days_in_period__lt
number optional
loan__business_days_in_period__lte
number optional
loan__business_days_in_period__gt
number optional
loan__business_days_in_period__gte
number optional
loan__business_days_in_period__in
number optional

Multiple values may be separated by commas.

loan__end_user__id
string optional
loan__end_user__id__iexact
string optional
loan__end_user__id__contains
string optional
loan__end_user__id__icontains
string optional
loan__end_user__id__in
string optional

Multiple values may be separated by commas.

loan__end_user__created
string optional
loan__end_user__created__lt
string optional
loan__end_user__created__lte
string optional
loan__end_user__created__gt
string optional
loan__end_user__created__gte
string optional
loan__end_user__created__in
string optional

Multiple values may be separated by commas.

loan__end_user__created__year
number optional
loan__end_user__created__year__lt
number optional
loan__end_user__created__year__lte
number optional
loan__end_user__created__year__gt
number optional
loan__end_user__created__year__gte
number optional
loan__end_user__created__year__in
number optional

Multiple values may be separated by commas.

loan__end_user__created__month
number optional
loan__end_user__created__month__lt
number optional
loan__end_user__created__month__lte
number optional
loan__end_user__created__month__gt
number optional
loan__end_user__created__month__gte
number optional
loan__end_user__created__month__in
number optional

Multiple values may be separated by commas.

loan__end_user__created__day
number optional
loan__end_user__created__day__lt
number optional
loan__end_user__created__day__lte
number optional
loan__end_user__created__day__gt
number optional
loan__end_user__created__day__gte
number optional
loan__end_user__created__day__in
number optional

Multiple values may be separated by commas.

loan__end_user__updated
string optional
loan__end_user__updated__lt
string optional
loan__end_user__updated__lte
string optional
loan__end_user__updated__gt
string optional
loan__end_user__updated__gte
string optional
loan__end_user__updated__in
string optional

Multiple values may be separated by commas.

loan__end_user__updated__year
number optional
loan__end_user__updated__year__lt
number optional
loan__end_user__updated__year__lte
number optional
loan__end_user__updated__year__gt
number optional
loan__end_user__updated__year__gte
number optional
loan__end_user__updated__year__in
number optional

Multiple values may be separated by commas.

loan__end_user__updated__month
number optional
loan__end_user__updated__month__lt
number optional
loan__end_user__updated__month__lte
number optional
loan__end_user__updated__month__gt
number optional
loan__end_user__updated__month__gte
number optional
loan__end_user__updated__month__in
number optional

Multiple values may be separated by commas.

loan__end_user__updated__day
number optional
loan__end_user__updated__day__lt
number optional
loan__end_user__updated__day__lte
number optional
loan__end_user__updated__day__gt
number optional
loan__end_user__updated__day__gte
number optional
loan__end_user__updated__day__in
number optional

Multiple values may be separated by commas.

loan__end_user__first_name
string optional
loan__end_user__first_name__iexact
string optional
loan__end_user__first_name__contains
string optional
loan__end_user__first_name__icontains
string optional
loan__end_user__first_name__in
string optional

Multiple values may be separated by commas.

loan__end_user__last_name
string optional
loan__end_user__last_name__iexact
string optional
loan__end_user__last_name__contains
string optional
loan__end_user__last_name__icontains
string optional
loan__end_user__last_name__in
string optional

Multiple values may be separated by commas.

loan__end_user__birth_date
string optional
loan__end_user__birth_date__lt
string optional
loan__end_user__birth_date__lte
string optional
loan__end_user__birth_date__gt
string optional
loan__end_user__birth_date__gte
string optional
loan__end_user__birth_date__in
string optional

Multiple values may be separated by commas.

loan__end_user__birth_date__year
number optional
loan__end_user__birth_date__year__lt
number optional
loan__end_user__birth_date__year__lte
number optional
loan__end_user__birth_date__year__gt
number optional
loan__end_user__birth_date__year__gte
number optional
loan__end_user__birth_date__year__in
number optional

Multiple values may be separated by commas.

loan__end_user__birth_date__month
number optional
loan__end_user__birth_date__month__lt
number optional
loan__end_user__birth_date__month__lte
number optional
loan__end_user__birth_date__month__gt
number optional
loan__end_user__birth_date__month__gte
number optional
loan__end_user__birth_date__month__in
number optional

Multiple values may be separated by commas.

loan__end_user__birth_date__day
number optional
loan__end_user__birth_date__day__lt
number optional
loan__end_user__birth_date__day__lte
number optional
loan__end_user__birth_date__day__gt
number optional
loan__end_user__birth_date__day__gte
number optional
loan__end_user__birth_date__day__in
number optional

Multiple values may be separated by commas.

loan__end_user__address_line_1
string optional
loan__end_user__address_line_1__iexact
string optional
loan__end_user__address_line_1__contains
string optional
loan__end_user__address_line_1__icontains
string optional
loan__end_user__address_line_1__in
string optional

Multiple values may be separated by commas.

loan__end_user__address_line_2
string optional
loan__end_user__address_line_2__iexact
string optional
loan__end_user__address_line_2__contains
string optional
loan__end_user__address_line_2__icontains
string optional
loan__end_user__address_line_2__in
string optional

Multiple values may be separated by commas.

loan__end_user__address_line_3
string optional
loan__end_user__address_line_3__iexact
string optional
loan__end_user__address_line_3__contains
string optional
loan__end_user__address_line_3__icontains
string optional
loan__end_user__address_line_3__in
string optional

Multiple values may be separated by commas.

loan__end_user__city
string optional
loan__end_user__city__iexact
string optional
loan__end_user__city__contains
string optional
loan__end_user__city__icontains
string optional
loan__end_user__city__in
string optional

Multiple values may be separated by commas.

loan__end_user__postal_code
string optional
loan__end_user__postal_code__iexact
string optional
loan__end_user__postal_code__contains
string optional
loan__end_user__postal_code__icontains
string optional
loan__end_user__postal_code__in
string optional

Multiple values may be separated by commas.

loan__end_user__country
string optional
loan__end_user__country__iexact
string optional
loan__end_user__country__contains
string optional
loan__end_user__country__icontains
string optional
loan__end_user__country__in
string optional

Multiple values may be separated by commas.

loan__end_user__bank_account_number
string optional
loan__end_user__bank_account_number__iexact
string optional
loan__end_user__bank_account_number__contains
string optional
loan__end_user__bank_account_number__icontains
string optional
loan__end_user__bank_account_number__in
string optional

Multiple values may be separated by commas.

loan__end_user__sort_code
string optional
loan__end_user__sort_code__iexact
string optional
loan__end_user__sort_code__contains
string optional
loan__end_user__sort_code__icontains
string optional
loan__end_user__sort_code__in
string optional

Multiple values may be separated by commas.

loan__end_user__mobile_number
string optional
loan__end_user__mobile_number__iexact
string optional
loan__end_user__mobile_number__contains
string optional
loan__end_user__mobile_number__icontains
string optional
loan__end_user__mobile_number__in
string optional

Multiple values may be separated by commas.

loan__end_user__email
string optional
loan__end_user__email__iexact
string optional
loan__end_user__email__contains
string optional
loan__end_user__email__icontains
string optional
loan__end_user__email__in
string optional

Multiple values may be separated by commas.

loan__application__id
string optional
loan__application__id__iexact
string optional
loan__application__id__contains
string optional
loan__application__id__icontains
string optional
loan__application__id__in
string optional

Multiple values may be separated by commas.

loan__application__created
string optional
loan__application__created__lt
string optional
loan__application__created__lte
string optional
loan__application__created__gt
string optional
loan__application__created__gte
string optional
loan__application__created__in
string optional

Multiple values may be separated by commas.

loan__application__created__year
number optional
loan__application__created__year__lt
number optional
loan__application__created__year__lte
number optional
loan__application__created__year__gt
number optional
loan__application__created__year__gte
number optional
loan__application__created__year__in
number optional

Multiple values may be separated by commas.

loan__application__created__month
number optional
loan__application__created__month__lt
number optional
loan__application__created__month__lte
number optional
loan__application__created__month__gt
number optional
loan__application__created__month__gte
number optional
loan__application__created__month__in
number optional

Multiple values may be separated by commas.

loan__application__created__day
number optional
loan__application__created__day__lt
number optional
loan__application__created__day__lte
number optional
loan__application__created__day__gt
number optional
loan__application__created__day__gte
number optional
loan__application__created__day__in
number optional

Multiple values may be separated by commas.

loan__application__updated
string optional
loan__application__updated__lt
string optional
loan__application__updated__lte
string optional
loan__application__updated__gt
string optional
loan__application__updated__gte
string optional
loan__application__updated__in
string optional

Multiple values may be separated by commas.

loan__application__updated__year
number optional
loan__application__updated__year__lt
number optional
loan__application__updated__year__lte
number optional
loan__application__updated__year__gt
number optional
loan__application__updated__year__gte
number optional
loan__application__updated__year__in
number optional

Multiple values may be separated by commas.

loan__application__updated__month
number optional
loan__application__updated__month__lt
number optional
loan__application__updated__month__lte
number optional
loan__application__updated__month__gt
number optional
loan__application__updated__month__gte
number optional
loan__application__updated__month__in
number optional

Multiple values may be separated by commas.

loan__application__updated__day
number optional
loan__application__updated__day__lt
number optional
loan__application__updated__day__lte
number optional
loan__application__updated__day__gt
number optional
loan__application__updated__day__gte
number optional
loan__application__updated__day__in
number optional

Multiple values may be separated by commas.

loan__application__status
string optional
loan__application__status__iexact
string optional
loan__application__status__contains
string optional
loan__application__status__icontains
string optional
loan__application__status__in
string optional

Multiple values may be separated by commas.

loan__application__product
string optional
loan__application__product__lt
string optional
loan__application__product__lte
string optional
loan__application__product__gt
string optional
loan__application__product__gte
string optional
loan__application__product__in
string optional

Multiple values may be separated by commas.

loan__application__end_user
string optional
loan__application__end_user__lt
string optional
loan__application__end_user__lte
string optional
loan__application__end_user__gt
string optional
loan__application__end_user__gte
string optional
loan__application__end_user__in
string optional

Multiple values may be separated by commas.

loan__application__amount
number optional
loan__application__amount__lt
number optional
loan__application__amount__lte
number optional
loan__application__amount__gt
number optional
loan__application__amount__gte
number optional
loan__application__amount__in
number optional

Multiple values may be separated by commas.

loan__application__installments
number optional
loan__application__installments__lt
number optional
loan__application__installments__lte
number optional
loan__application__installments__gt
number optional
loan__application__installments__gte
number optional
loan__application__installments__in
number optional

Multiple values may be separated by commas.

loan__application__rate
number optional
loan__application__rate__lt
number optional
loan__application__rate__lte
number optional
loan__application__rate__gt
number optional
loan__application__rate__gte
number optional
loan__application__rate__in
number optional

Multiple values may be separated by commas.

loan__application__reason
string optional
loan__application__reason__iexact
string optional
loan__application__reason__contains
string optional
loan__application__reason__icontains
string optional
loan__application__reason__in
string optional

Multiple values may be separated by commas.

loan__application__processing_finished_at
string optional
loan__application__processing_finished_at__lt
string optional
loan__application__processing_finished_at__lte
string optional
loan__application__processing_finished_at__gt
string optional
loan__application__processing_finished_at__gte
string optional
loan__application__processing_finished_at__in
string optional

Multiple values may be separated by commas.

loan__application__processing_finished_at__year
number optional
loan__application__processing_finished_at__year__lt
number optional
loan__application__processing_finished_at__year__lte
number optional
loan__application__processing_finished_at__year__gt
number optional
loan__application__processing_finished_at__year__gte
number optional
loan__application__processing_finished_at__year__in
number optional

Multiple values may be separated by commas.

loan__application__processing_finished_at__month
number optional
loan__application__processing_finished_at__month__lt
number optional
loan__application__processing_finished_at__month__lte
number optional
loan__application__processing_finished_at__month__gt
number optional
loan__application__processing_finished_at__month__gte
number optional
loan__application__processing_finished_at__month__in
number optional

Multiple values may be separated by commas.

loan__application__processing_finished_at__day
number optional
loan__application__processing_finished_at__day__lt
number optional
loan__application__processing_finished_at__day__lte
number optional
loan__application__processing_finished_at__day__gt
number optional
loan__application__processing_finished_at__day__gte
number optional
loan__application__processing_finished_at__day__in
number optional

Multiple values may be separated by commas.

sort
string optional

Responses

200 200

200

Create a transaction for a loan account
POST /api/v1/transactions/transaction/

Authentication

api_key

View set for managing transactions

Request body

application/json
Object
loan
string required

The ID of the loan you wich to apply the transaction to

type
string required

The type of the transaction

Enumeration:
disbursement

The transaction adds a disursement to a loan account. If the payments provider module is enable this will disburse funds to the end user bank account.

repayment

This transaction adds a repayment transaction to the loan account.If the collections module is enable this will create a repayment request from the collections provider.

fee
fee_name
string

A readable name for this fee transation. If the prodcut of the loan account this transaction is created for has a fee with that name, then the amount and fee_type should remain empty. If there isn’t such fee then they are required.

amount
number

(Only for a non default fee) This field represents the amount of the fee or the percentage of the current balance to be calculated as the amount of the fee.

fee_type
string

(Only for a non default fee) Describes whether the fee should be calculated as flat fee or as percetage from the account balance.

Enumeration:
flat

For this type of fee, the figure in the amount field will be used to calculate the fee.

percent

This type of fee is calculated as percentage of the account balance. The figure in the amount field represents that percentage.

idempotency_key
string required

A unique key for this transaction. This key is very important as it’s serves as a unique identifier for a transactio and the API will ensure this payment is only ever created once. This means that if an API request times out or something goes wrong on your end, you won’t ever accidentally disburse a loan twice or charge the end user twice.

custom_field
string

Responses

201 201

201

Get a specific transaction
GET /api/v1/transactions/transaction/{id}/

Authentication

api_key

View set for managing transactions

Path variables

id
string required

A UUID string identifying this Transaction.

Responses

200 200

200

Revert a specific transaction.
POST /api/v1/transactions/transaction/{id}/revert/

Authentication

api_key

This endpoint is used to revert a specific transaction. Since all the transactions are linked and depended on one another, reverting a transaction will also revert all the transactions that postdated it. Only transactions that are is applied status can be reverted. This means that a reuqest to revert an applied transaction would fail, also a request to revert a transaction which one of the transactions that postdate it isn’t applied yet will fail.

Path variables

id
string required

A UUID string identifying this Transaction.

Request body

application/json
Object
loan
string required
type
string required
amount
number
fee_name
string
fee_type
string
idempotency_key
string required
custom_field
string

Responses

201 201

201