Cready API

Cready API (v1)

Download OpenAPI specification:Download

Alpha version

client

List all clients

This endpoint lists available clients

Authorizations:
Bearer
query Parameters
Page
integer <int32>
RowsPerPage
integer <int32>

Responses

Response samples

Content type
No sample

debt

List all debts

This endpoint lists all debts

Authorizations:
Bearer
path Parameters
clientId
required
string
query Parameters
ActiveStatus
integer <int32>
UnderStatus
integer <int32>
MainStatus
integer <int32>
PaymentStatus
integer <int32>
SearchType
integer <int32>
Page
integer <int32>
RowsPerPage
integer <int32>
SearchTerm
string

Responses

Response samples

Content type
No sample

Create a debt

This endpoint will create a debt

Authorizations:
Bearer
path Parameters
clientId
required
string <uuid>
Request Body schema:
isCorporation
required
boolean <bool>

Set to true if the debtor is a corporation

identificationNumber
required
string <organization number / personal number> non-empty

Organization number if IsCorporation is set to true, otherwise personal number

name
required
string <string> non-empty

Name of debtor

required
object (Address)
email
string or null <contactInformation>

Contact information

phone
string or null <email>

Email

Array of objects or null (CreateDebtModel)

Responses

Request samples

Content type
{
  • "isCorporation": true,
  • "identificationNumber": "string",
  • "name": "string",
  • "address": {
    },
  • "email": "string",
  • "phone": "user@example.com",
  • "debts": [
    ]
}

Response samples

Content type
No sample

Get a debt summary

This endpoint will get a debt

Authorizations:
Bearer
path Parameters
id
required
integer <int32>
clientId
required
string

Responses

Response samples

Content type
No sample

Add payment to a debt

This endpoint will add a payment to a debt

Authorizations:
Bearer
path Parameters
clientId
required
string <uuid>
Request Body schema:
debtId
required
integer <int>

Payment amount

amount
required
integer <int>

Payment amount

transactionDate
required
string <date>

Transaction date

invoiceId
required
integer <int>

InvoiceId

Responses

Request samples

Content type
{
  • "debtId": 0,
  • "amount": 0,
  • "transactionDate": "2019-08-24",
  • "invoiceId": 0
}

Response samples

Content type
No sample

Withdraw a debt

This endpoint will withdraw an existing debt

Authorizations:
Bearer
path Parameters
clientId
required
string <uuid>
Request Body schema:
id
required
integer <int32>
clientId
string <uuid>
comment
string or null

Responses

Request samples

Content type
{
  • "id": 0,
  • "clientId": "5e505642-9024-474d-9434-e5a44f505cc5",
  • "comment": "string"
}

Response samples

Content type
No sample

summary

Get a debt summary

This endpoint will get a debt

Authorizations:
Bearer
path Parameters
id
required
integer <int32>
clientId
required
string

Responses

Response samples

Content type
No sample

Get an invoice summary

This endpoint will get an invoice summary

Authorizations:
Bearer
path Parameters
id
required
integer <int32>
clientId
required
string

Responses

Response samples

Content type
No sample

payment

Add payment to a debt

This endpoint will add a payment to a debt

Authorizations:
Bearer
path Parameters
clientId
required
string <uuid>
Request Body schema:
debtId
required
integer <int>

Payment amount

amount
required
integer <int>

Payment amount

transactionDate
required
string <date>

Transaction date

invoiceId
required
integer <int>

InvoiceId

Responses

Request samples

Content type
{
  • "debtId": 0,
  • "amount": 0,
  • "transactionDate": "2019-08-24",
  • "invoiceId": 0
}

Response samples

Content type
No sample

document

Gets a document

This endpoint downloads a document

Authorizations:
Bearer
path Parameters
id
required
string <uuid>
clientId
required
string

Responses

Response samples

Content type
No sample

invoice

List all invoices

This endpoint lists all invoices

Authorizations:
Bearer
path Parameters
clientId
required
string
query Parameters
PaymentStatus
integer <int32>
ReceivableMainStatus
integer <int32>
ReceivableSubStatus
integer <int32>
IsCompleted
boolean
ActiveStatus
integer <int32>
SearchType
integer <int32>
ClientId
integer <int32>
Page
integer <int32>
RowsPerPage
integer <int32>
SearchTerm
string

Responses

Response samples

Content type
No sample

Add an invoice

This endpoint will create a new invoice

Authorizations:
Bearer
path Parameters
clientId
required
string <uuid>
Request Body schema:
invoiceNumber
required
string <string> non-empty

Unique invoice number

invoiceDate
required
string <date>

Invoice date

daysUntilExpiration
required
integer <int>

Number of days before expiration

dueDate
required
string <date>

Due date

interestRate
number or null <decimal>

Interest rate

totalExcludingVAT
required
number <decimal>

Total amount excluding VAT

totalVATAmount
required
number <decimal>

Total VAT amount

totalAmountIncludingVAT
required
number <decimal>

Total amount including VAT

reminderDate
string or null <date>

Reminder date

reminderFee
number or null <decimal>

Reminder fee

required
Array of objects (Article)

Articles

Responses

Request samples

Content type
{
  • "invoiceNumber": "string",
  • "invoiceDate": "2019-08-24",
  • "daysUntilExpiration": 0,
  • "dueDate": "2019-08-24",
  • "interestRate": 0,
  • "totalExcludingVAT": 0,
  • "totalVATAmount": 0,
  • "totalAmountIncludingVAT": 0,
  • "reminderDate": "2019-08-24",
  • "reminderFee": 0,
  • "articles": [
    ]
}

Response samples

Content type
No sample

Withdraw an invoice

This endpoint will withdraw an existing invoice

Authorizations:
Bearer
path Parameters
clientId
required
string <uuid>
id
required
string <uuid>
Request Body schema:
id
required
string <uuid>

Responses

Request samples

Content type
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Response samples

Content type
No sample

Get an invoice summary

This endpoint will get an invoice summary

Authorizations:
Bearer
path Parameters
id
required
integer <int32>
clientId
required
string

Responses

Response samples

Content type
No sample