Centtrip API (v1)

Download OpenAPI specification:Download

Centtrip Public API: tech@centtrip.com Terms of Service

API for Centtrip Ltd

Account

Get accounts

Get accounts to which you have access to

Authorizations:
OAuth2
query Parameters
pageSize
integer <int32>
Example: pageSize=10

Page size

cursor
string
Example: cursor=8de298de-6ba6-44c7-b00f-529672f2f522

Cursor to get the next or previous page

Responses

Response samples

Content type
application/json
{}

Get account balance

Get balances associated with the account

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

Responses

Response samples

Content type
application/json
{
  • "value": [
    ],
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Get account transactions

Get transactions associated with an account

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

query Parameters
startDateTime
string or null <date-time>
endDateTime
string or null <date-time>
currency
string or null
pageSize
integer or null <int32>
prevDateTime
string or null <date-time>
nextDateTime
string or null <date-time>
excludedRefIds
Array of strings or null <uuid>

Responses

Response samples

Content type
application/json
{
  • "next": "/api/v1/accounts/5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1/transactions?pageSize=25&nextDateTime=2021-12-20T10%3A28%3A28.7256990Z&excludedRefIds=281456bc-766d-4ab6-bc13-4d59cbc3298b",
  • "value": [
    ],
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Get account transaction documents

Get documents associated with the account transaction

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

transactionId
required
string <uuid>
Example: 306149db-5f46-483b-9a3d-fa32993f9748

Transaction Identifier

Responses

Response samples

Content type
application/json
{
  • "value": [
    ],
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Get account transaction document

Get document details associated with the account transaction. The URL for the document is only valid for 5 minutes.

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

transactionId
required
string <uuid>
Example: 306149db-5f46-483b-9a3d-fa32993f9748

Transaction Identifier

documentId
required
string <uuid>
Example: e5d9b0b1-7449-4254-8461-84366c71352d

Document Identifier

Responses

Response samples

Add account transaction references

Add multiple references to an account transaction

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

Request Body schema: application/json
journalRefIds
Array of strings or null <uuid>
reference
string or null

Responses

Request samples

Content type
application/json
{
  • "journalRefIds": [
    ],
  • "reference": "MyReference"
}

Response samples

Content type
application/json
{
  • "value": [
    ],
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Get account transaction references

Get references associated with the account transaction

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

transactionId
required
string <uuid>
Example: 306149db-5f46-483b-9a3d-fa32993f9748

Transaction Identifier

Responses

Response samples

Content type
application/json
{
  • "value": [
    ],
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Delete account transaction references

Delete references associated with account transaction

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

transactionId
required
string <uuid>
Example: 306149db-5f46-483b-9a3d-fa32993f9748

Transaction Identifier

Request Body schema: application/json
reference
string or null

Responses

Request samples

Content type
application/json
{
  • "reference": "MyReference"
}

Response samples

Content type
application/json
{
  • "value": {
    },
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Get card transactions

Get all card transactions associated with the account

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

query Parameters
startDateTime
string <date-time>
endDateTime
string <date-time>
currency
string
pageSize
integer <int32>
prevDateTime
string <date-time>
nextDateTime
string <date-time>
excludedRefIds
Array of strings <uuid>
hasDocument
boolean
reference
string
referenceOperator
string (QueryOperator)
Enum: "None" "HasValue" "HasNoValue" "EqualTo" "DoesNotContain"

Responses

Response samples

Content type
application/json
{
  • "next": "/api/v1/accounts/5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1/cardTransactions?pageSize=100&nextDateTime=2020-07-10T09%3A45%3A15.5473160Z&excludedRefIds=9e8e1a88-c0a7-4e9d-88a9-05534703150d",
  • "value": [
    ],
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Card

Get cards

Get cards associated with the account

Authorizations:
OAuth2
query Parameters
accountId
string
Example: accountId=5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

cardholderId
integer <int64>
Example: cardholderId=400012345678

Card holder identifier to search for

pageSize
integer <int32>
Example: pageSize=10

Page size

cursor
string
Example: cursor=8de298de-6ba6-44c7-b00f-529672f2f522

Cursor to get the next or previous page

Responses

Response samples

Content type
application/json
{
  • "value": [
    ],
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Get card balance

Get balances associated with the card

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

cardId
required
string
Example: 6d98ea63-5f85-4ca5-8ae4-a74cd5aec1a6--61ab2ebe-1a0e-49c8-8fc4-2fc7cc2bc0ea

Card Identifier

Responses

Response samples

Content type
application/json
{
  • "value": [
    ],
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Get card transactions

Get transactions associated with the card

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

cardId
required
string
Example: 6d98ea63-5f85-4ca5-8ae4-a74cd5aec1a6--61ab2ebe-1a0e-49c8-8fc4-2fc7cc2bc0ea

Card Identifier

query Parameters
startDateTime
string or null <date-time>
endDateTime
string or null <date-time>
currency
string or null
pageSize
integer or null <int32>
prevDateTime
string or null <date-time>
nextDateTime
string or null <date-time>
excludedRefIds
Array of strings or null <uuid>

Responses

Response samples

Content type
application/json
{
  • "value": [
    ],
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Get card transaction documents

Get documents associated with the card transaction

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

cardId
required
string
Example: 6d98ea63-5f85-4ca5-8ae4-a74cd5aec1a6--61ab2ebe-1a0e-49c8-8fc4-2fc7cc2bc0ea

Card Identifier

transactionId
required
string <uuid>
Example: fc60f04b-a196-4163-8f43-e035eb9c28c5

Transaction Identifier

Responses

Response samples

Content type
application/json
{
  • "value": [
    ],
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Get card transaction document

Get document associated with the card transaction. The URL for the document is only valid for 5 minutes.

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

cardId
required
string
Example: 6d98ea63-5f85-4ca5-8ae4-a74cd5aec1a6--61ab2ebe-1a0e-49c8-8fc4-2fc7cc2bc0ea

Card Identifier

transactionId
required
string <uuid>
Example: fc60f04b-a196-4163-8f43-e035eb9c28c5

Transaction Identifier

documentId
required
string <uuid>
Example: adee1cf7-cf14-4453-bfda-bf2a572803c0

Transaction Identifier

Responses

Response samples

Delete document

Delete document

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

cardId
required
string
Example: 6d98ea63-5f85-4ca5-8ae4-a74cd5aec1a6--61ab2ebe-1a0e-49c8-8fc4-2fc7cc2bc0ea

Card Identifier

transactionId
required
string <uuid>
Example: fc60f04b-a196-4163-8f43-e035eb9c28c5

Transaction Identifier

documentId
required
string <uuid>
Example: adee1cf7-cf14-4453-bfda-bf2a572803c0

Transaction Identifier

Responses

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Create card transaction references

Create references associated with a card transaction

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

cardId
required
string
Example: 6d98ea63-5f85-4ca5-8ae4-a74cd5aec1a6--61ab2ebe-1a0e-49c8-8fc4-2fc7cc2bc0ea

Card Identifier

Request Body schema: application/json
journalRefIds
Array of strings or null <uuid>
reference
string or null

Responses

Request samples

Content type
application/json
{
  • "journalRefIds": [
    ],
  • "reference": "MyReference"
}

Response samples

Content type
application/json
{
  • "value": [
    ],
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Get card transaction references

Get references associated with the card transaction

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

cardId
required
string
Example: 6d98ea63-5f85-4ca5-8ae4-a74cd5aec1a6--61ab2ebe-1a0e-49c8-8fc4-2fc7cc2bc0ea

Card Identifier

transactionId
required
string <uuid>
Example: fc60f04b-a196-4163-8f43-e035eb9c28c5

Transaction Identifier

Responses

Response samples

Content type
application/json
{
  • "value": [
    ],
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Delete card transaction references

Delete references associated with card transaction

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

cardId
required
string
Example: 6d98ea63-5f85-4ca5-8ae4-a74cd5aec1a6--61ab2ebe-1a0e-49c8-8fc4-2fc7cc2bc0ea

Card Identifier

transactionId
required
string <uuid>
Example: fc60f04b-a196-4163-8f43-e035eb9c28c5

Transaction Identifier

Request Body schema: application/json
reference
string or null

Responses

Request samples

Content type
application/json
{
  • "reference": "MyReference"
}

Response samples

Content type
application/json
{
  • "value": {
    },
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Get card transaction note

Get card transaction note

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

cardId
required
string
Example: 6d98ea63-5f85-4ca5-8ae4-a74cd5aec1a6--61ab2ebe-1a0e-49c8-8fc4-2fc7cc2bc0ea

Card Identifier

transactionId
required
string <uuid>
Example: fc60f04b-a196-4163-8f43-e035eb9c28c5

Transaction Identifier

Responses

Response samples

Content type
No sample

Corporate Labels

Get label groups associated with the account

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

query Parameters
id
Array of strings <uuid>
code
Array of strings <uuid>
groupName
Array of strings
allowMobile
boolean
atDateTime
string <date-time>
pageNumber
required
integer <int32> >= 1
pageSize
required
integer <int32> [ 10 .. 100 ]

Responses

Response samples

Content type
application/json
{
  • "value": [
    ],
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": {
    }
}

Create label groups associated with the account

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

Request Body schema: application/json
groupName
string or null
allowMobile
boolean

Responses

Request samples

Content type
application/json
{
  • "groupName": "My Corporate Label Group",
  • "allowMobile": true
}

Response samples

Content type
application/json
{
  • "value": {
    },
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Update label groups associated with the account

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

Request Body schema: application/json
id
string or null <uuid>
groupName
string or null
allowMobile
boolean
object (Centtrip.Orchestrator.Api.Models.RequestStateViewModel)

Responses

Request samples

Content type
application/json
{
  • "id": "3e6d5ddb-6ff0-4222-98ab-c28c8b402fb4",
  • "groupName": "My Other Corporate Label Group",
  • "allowMobile": true,
  • "state": {
    }
}

Response samples

Content type
application/json
{
  • "value": {
    },
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Delete label groups associated with the account

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

Request Body schema: application/json
id
string or null <uuid>
object (Centtrip.Orchestrator.Api.Models.RequestStateViewModel)

Responses

Request samples

Content type
application/json
{
  • "id": "6792cc78-41fd-473a-a16b-2e67aa74d7be",
  • "state": {
    }
}

Response samples

Content type
application/json
{
  • "value": {
    },
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Get corporate labels associated with the account

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

query Parameters
id
Array of strings <uuid>
corporateLabelGroupCode
required
Array of strings <uuid>
accountingCode
Array of strings
labelName
Array of strings
code
Array of strings <uuid>
atDateTime
string <date-time>
pageNumber
required
integer <int32> >= 1
pageSize
required
integer <int32> [ 10 .. 100 ]

Responses

Response samples

Content type
application/json
{
  • "value": [
    ],
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": {
    }
}

Create corporate labels associated with the account

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

Request Body schema: application/json
corporateLabelGroupCode
string <uuid>
accountingCode
string
labelName
string

Responses

Request samples

Content type
application/json
{
  • "corporateLabelGroupCode": "519213b4-b07f-46f6-953a-c8ee96252db9",
  • "accountingCode": "12345",
  • "labelName": "Food & Beverage"
}

Response samples

Content type
application/json
{
  • "value": {
    },
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Update corporate label associated with the account

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

Request Body schema: application/json
id
string or null <uuid>
accountingCode
string or null
labelName
string or null
object (Centtrip.Orchestrator.Api.Models.RequestStateViewModel)

Responses

Request samples

Content type
application/json
{
  • "id": "674b2b8a-35bf-40a9-8400-4ceb347cbe1f",
  • "accountingCode": "54321",
  • "labelName": "Food & Beverage",
  • "state": {
    }
}

Response samples

Content type
application/json
{
  • "value": {
    },
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Delete corporate label associated with the account

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

Request Body schema: application/json
id
string <uuid>
object (Centtrip.Orchestrator.Api.Models.RequestStateViewModel)

Responses

Request samples

Content type
application/json
{
  • "id": "542a35ae-6cbb-421e-8e9f-f3b74faffb15",
  • "state": {
    }
}

Response samples

Content type
application/json
{
  • "value": {
    },
  • "isSuccess": true,
  • "code": 0,
  • "message": null,
  • "data": null
}

Set corporate label relationship associated with the account

Authorizations:
OAuth2ApiKey
path Parameters
accountId
required
string
Example: 5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1

Account Identifier

Request Body schema: application/json
transactionRefId
string or null <uuid>
Array of objects or null (Centtrip.Orchestrator.Api.Models.CorporateLabels.CorporateLabelRelationship.GroupLabelRelation)

Responses

Request samples

Content type
application/json
{
  • "transactionRefId": "6cd43ad7-b40b-46fc-9a56-021cddf6147e",
  • "relations": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Card Transfers

Transfer funds

Transfer funds from card to account and vice versa

Authorizations:
OAuth2
Request Body schema: application/json
accountId
required
string

Account Identifier

cardId
required
string

Card Identifier

currencyCode
required
string
amount
required
number
direction
required
string (CardTransferDirection)
Enum: "AccountToCard" "CardToAccount"

Responses

Request samples

Content type
application/json
{
  • "accountId": "5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1",
  • "cardId": "5e892ea0-dbf8-4b13-bf18-3f40a94d5149--eccf37ca-1ded-4f30-bfa3-10fcac3e41a0",
  • "currencyCode": "GBP",
  • "amount": 10.5,
  • "direction": "AccountToCard"
}

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "message": null,
  • "data": null
}

Payments

Create payment with recipient

Authorizations:
OAuth2
Request Body schema: application/json
accountId
string

Account Identifier

amount
number <double>
reason
string or null
reference
string or null
countryCode
string or null
currencyCode
string or null
firstName
string or null
lastName
string or null
companyName
string or null
email
string or null
phoneNumber
string or null
address1
string or null
address2
string or null
city
string or null
postcode
string or null
state
string or null
bankAccountNumber
string or null
bankIban
string or null
bankSortCode
string or null
bankBic
string or null
bankAba
string or null
bankClabe
string or null
override
string or null
accountHolderPhoneNumber
string or null
additionalDetails
string or null
beneficiaryBankBranchName
string or null
beneficiaryCedulaId
string or null
beneficiaryContactName
string or null
beneficiaryInn
string or null
beneficiaryKbe
string or null
beneficiaryKnp
string or null
beneficiaryPaymentClassification
string or null
beneficiaryRif
string or null
beneficiaryRut
string or null
beneficiaryTaxId
string or null
beneficiaryTrn
string or null
beneficiaryVo
string or null
includeVaTax
string or null

Responses

Request samples

Content type
application/json
{
  • "accountId": "5e892ea0-dbf8-4b13-bf18-3f40a94d5149--ecd56cb7-21ff-4a59-9ef0-e21af038c9e1",
  • "currencyCode": "GBP",
  • "amount": 100.25,
  • "reason": "My Reason",
  • "reference": "Invoice #12",
  • "companyName": "Centtrip",
  • "address1": "1 Mark Square",
  • "city": "London",
  • "postcode": "EC2A 4EG",
  • "countryCode": "GB",
  • "bankAccountNumber": "12345678",
  • "bankSortCode": "112233"
}

Response samples

Content type
application/json
{
  • "isSuccess": true,
  • "message": null,
  • "data": null
}