Monto API (1.0.0)

Download OpenAPI specification:Download

E-mail: dev@monto.ai License: Monto AB

API Documentation for Monto Connect & Monto Assess

Integration

An Integration represents a data source, that a Company can connect towards via Connection's.

Get integrations

Returns all integrations supported by Monto.

SecurityAPIKeyAuth

Responses

200

get/integrations

Response samples

application/json

{"integrations": [{"key": "FORTNOX",
"label": "Fortnox",
"sourceType": "ERP",
"authType": "REDIRECT",
"enabled": true,
"fields": [ ]
}
],
"meta": {"currentPage": 1,
"totalPages": 2,
"pageSize": 50
},
"links": {"first": "https://api.monto.ai/...?page=1&size=50...",
"prev": null,
"next": "https://api.monto.ai/...?page=2&size=50...",
"last": "https://api.monto.ai/...?page=1&size=50..."
}
}

Get integration

Returns a single integration.

SecurityAPIKeyAuth

Request

path Parameters

integration-key

required

string

The key of a specific Integration.

Example: FORTNOX

Responses

200

404

Not Found

get/integrations/{integration-key}

Response samples

application/json

{"key": "FORTNOX",
"label": "Fortnox",
"sourceType": "ERP",
"authType": "REDIRECT",
"enabled": true,
"fields": [ ]
}

Connection

A Connection represents a link between a Company and a third-party Integration.

Get connections

Get a list of all Connections.

SecurityAPIKeyAuth

Request

path Parameters

company-uuid

required

string <uuid>

Unique identifier of company

Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d

Responses

200

404

Not Found

get/companies/{company-uuid}/connections

Response samples

application/json

{"connections": [{"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"status": "PENDING",
"connectUrl": "https://apps.fortnox.se/oauth-v1/login/...",
"integration": {"key": "FORTNOX",
"label": "Fortnox"
},
"lastUsedAt": null,
"createdAt": "2022-01-01T17:00:00Z"
}
]
}

Create connection

Creates a new Connection.

SecurityAPIKeyAuth

Request

path Parameters

company-uuid

required

string <uuid>

Unique identifier of company

Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d

Request Body schema: application/json

integrationKey	string (IntegrationEnum) The `key` of the Integration. Value: "FORTNOX"
redirectUrl	string An redirect url to which the end user is redirected to after completing the auth steps. Only required on integrations with authType REDIRECT
	Array of objects An array of fields, specified on each Integration.

Responses

200

404

Not Found

422

Unprocessable Entity

post/companies/{company-uuid}/connections

Request samples

Payload

application/json

{"integrationKey": "FORTNOX",
"redirectUrl": "https://www.monto.ai",
"fields": [ ]
}

Response samples

application/json

{"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"status": "PENDING",
"connectUrl": "https://apps.fortnox.se/oauth-v1/login/...",
"integration": {"key": "FORTNOX",
"label": "Fortnox"
},
"lastUsedAt": null,
"createdAt": "2022-01-01T17:00:00Z"
}

Update connection

Updates a Connection by UUID.

SecurityAPIKeyAuth

Request

path Parameters

company-uuid required	string <uuid> Unique identifier of company Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d
connection-uuid required	string <uuid> Unique identifier of connection. Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d

Request Body schema: application/json

status

string

The status of an Connection.

Enum: "ENABLED" "DISABLED_MANUALLY"

Responses

200

404

Not Found

422

Unprocessable Entity

patch/companies/{company-uuid}/connections/{connection-uuid}

Request samples

Payload

application/json

{"status": "DISABLED_MANUALLY"
}

Response samples

application/json

{"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"status": "PENDING",
"connectUrl": "https://apps.fortnox.se/oauth-v1/login/...",
"integration": {"key": "FORTNOX",
"label": "Fortnox"
},
"lastUsedAt": null,
"createdAt": "2022-01-01T17:00:00Z"
}

Company

A Company represents a business, sharing access to their data via Connections.

Get companies

Returns a list of companies.

SecurityAPIKeyAuth

Request

query Parameters

page	integer <int32> Default: 1 The paginated page number.
size	integer <int32> Default: 50 The pagination page size.

Responses

200

get/companies

Response samples

application/json

{"companies": [{"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"name": "Monto AB",
"addresses": [{"addressLineOne": "Kungsgatan 12-14",
"addressLineTwo": null,
"zipCode": "111 35",
"city": "Stockholm",
"country": "Sweden",
"type": "VISIT"
}
],
"businessId": "559028-3601"
}
],
"meta": {"currentPage": 1,
"totalPages": 2,
"pageSize": 50
},
"links": {"first": "https://api.monto.ai/...?page=1&size=50...",
"prev": null,
"next": "https://api.monto.ai/...?page=2&size=50...",
"last": "https://api.monto.ai/...?page=1&size=50..."
}
}

Create company

Create a new company.

SecurityAPIKeyAuth

Request

Request Body schema: application/json

name	string Name of the company

Responses

200

422

Unprocessable Entity

post/companies

Request samples

Payload

application/json

{"name": "Monto AB"
}

Response samples

application/json

{"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"name": "Monto AB",
"addresses": [{"addressLineOne": "Kungsgatan 12-14",
"addressLineTwo": null,
"zipCode": "111 35",
"city": "Stockholm",
"country": "Sweden",
"type": "VISIT"
}
],
"businessId": "559028-3601"
}

Get company

Returns a single company.

SecurityAPIKeyAuth

Request

path Parameters

company-uuid

required

string <uuid>

Unique identifier of company

Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d

Responses

200

404

Not Found

get/companies/{company-uuid}

Response samples

application/json

{"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"name": "Monto AB",
"addresses": [{"addressLineOne": "Kungsgatan 12-14",
"addressLineTwo": null,
"zipCode": "111 35",
"city": "Stockholm",
"country": "Sweden",
"type": "VISIT"
}
],
"businessId": "559028-3601"
}

Account Transaction

Account Transactions represents all activities within a Journal Entry.

Get account transactions

Returns a list of account transactions for a company.

SecurityAPIKeyAuth

Request

path Parameters

company-uuid

required

string <uuid>

Unique identifier of company

Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d

query Parameters

accounts	string A text explaining which account(s) to be included Example: accounts=1500-1599,1667,1200-1299
page	integer <int32> Default: 1 The paginated page number.
size	integer <int32> Default: 50 The pagination page size.

Responses

200

404

Not Found

get/companies/{company-uuid}/account-transactions

Response samples

application/json

{"accountTransactions": [{"accountNumber": 1790,
"accountName": "Övriga förutbetalda kostnader och upplupna intäkter",
"journalUuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"debet": {"amount": 100,
"currency": "SEK"
},
"credit": {"amount": 0,
"currency": "SEK"
},
"date": "2022-01-01T17:00:00Z"
}
],
"meta": {"currentPage": 1,
"totalPages": 2,
"pageSize": 50
},
"links": {"first": "https://api.monto.ai/...?page=1&size=50...",
"prev": null,
"next": "https://api.monto.ai/...?page=2&size=50...",
"last": "https://api.monto.ai/...?page=1&size=50..."
}
}

Journal

A Journal represents all business activies registered as Journal Entries.

Get journal entries

Returns a list of all Journal Entries for a Company.

SecurityAPIKeyAuth

Request

path Parameters

company-uuid

required

string <uuid>

Unique identifier of company

Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d

query Parameters

page	integer <int32> Default: 1 The paginated page number.
size	integer <int32> Default: 50 The pagination page size.

Responses

200

404

Not Found

get/companies/{company-uuid}/journals

Response samples

application/json

{"journalEntries": [{"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"number": 14,
"currency": "SEK",
"series": "A",
"description": "Kassarapport 2022-01-01",
"date": "2022-01-01T17:00:00Z",
"fiscalYear": {"from": "2021-05-01",
"to": "2022-04-30"
},
"accountTransactions": [{"accountNumber": 1790,
"accountName": "Övriga förutbetalda kostnader och upplupna intäkter",
"journalUuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"debet": {"amount": 100,
"currency": "SEK"
},
"credit": {"amount": 0,
"currency": "SEK"
},
"date": "2022-01-01T17:00:00Z"
}
]
}
],
"meta": {"currentPage": 1,
"totalPages": 2,
"pageSize": 50
},
"links": {"first": "https://api.monto.ai/...?page=1&size=50...",
"prev": null,
"next": "https://api.monto.ai/...?page=2&size=50...",
"last": "https://api.monto.ai/...?page=1&size=50..."
}
}

Get journal entry

Returns a single Journal Entry for a Company.

SecurityAPIKeyAuth

Request

path Parameters

company-uuid required	string <uuid> Unique identifier of company Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d
journal-uuid required	string <uuid> Unique identifier of journal Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d

Responses

200

404

Not Found

get/companies/{company-uuid}/journals/{journal-uuid}

Response samples

application/json

{"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"number": 14,
"currency": "SEK",
"series": "A",
"description": "Kassarapport 2022-01-01",
"date": "2022-01-01T17:00:00Z",
"fiscalYear": {"from": "2021-05-01",
"to": "2022-04-30"
},
"accountTransactions": [{"accountNumber": 1790,
"accountName": "Övriga förutbetalda kostnader och upplupna intäkter",
"journalUuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"debet": {"amount": 100,
"currency": "SEK"
},
"credit": {"amount": 0,
"currency": "SEK"
},
"date": "2022-01-01T17:00:00Z"
}
]
}

Account

Accounts are used to register account transactions in Journal Entries.

Get accounts

Returns an aggregated bundle of Account Transactions for a Company.

SecurityAPIKeyAuth

Request

path Parameters

company-uuid

required

string <uuid>

Unique identifier of company

Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d

query Parameters

accounts

required

string

A text explaining which account(s) to be included

Example: accounts=1500-1599,1667,1200-1299

Responses

200

404

Not Found

422

Unprocessable Entity

get/companies/{company-uuid}/accounts

Response samples

application/json

{"accounts": "1500-1599,1667,1200-1299",
"name": "Aggregated values for selected accounts.",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
}

Balance Sheet

A Balance Sheet shows the monthly balances by pre-defined account groups.

Get balance sheets

Returns bundled account balances for a Company.

SecurityAPIKeyAuth

Request

path Parameters

company-uuid

required

string <uuid>

Unique identifier of company

Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d

Responses

200

404

Not Found

get/companies/{company-uuid}/balance-sheets

Response samples

application/json

{"intangibleFixedAssets": {"accounts": "E.g. 1000-1099",
"name": "E.g. Immateriella anläggningstillgångar",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
},
"tangibleFixedAssets": {"accounts": "E.g. 1000-1099",
"name": "E.g. Immateriella anläggningstillgångar",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
},
"financialFixedAssets": {"accounts": "E.g. 1000-1099",
"name": "E.g. Immateriella anläggningstillgångar",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
},
"capitalAssets": {"accounts": "E.g. 1000-1099",
"name": "E.g. Immateriella anläggningstillgångar",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
},
"inventoriesEtc": {"accounts": "E.g. 1000-1099",
"name": "E.g. Immateriella anläggningstillgångar",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
},
"receivables": {"accounts": "E.g. 1000-1099",
"name": "E.g. Immateriella anläggningstillgångar",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
},
"shortTermInvestments": {"accounts": "E.g. 1000-1099",
"name": "E.g. Immateriella anläggningstillgångar",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
},
"cashAndBank": {"accounts": "E.g. 1000-1099",
"name": "E.g. Immateriella anläggningstillgångar",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
},
"currentAssets": {"accounts": "E.g. 1000-1099",
"name": "E.g. Immateriella anläggningstillgångar",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
},
"totalAssets": {"accounts": "E.g. 1000-1099",
"name": "E.g. Immateriella anläggningstillgångar",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
},
"equity": {"accounts": "E.g. 1000-1099",
"name": "E.g. Immateriella anläggningstillgångar",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
},
"untaxedReserves": {"accounts": "E.g. 1000-1099",
"name": "E.g. Immateriella anläggningstillgångar",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
},
"provisions": {"accounts": "E.g. 1000-1099",
"name": "E.g. Immateriella anläggningstillgångar",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
},
"longTermLiabilities": {"accounts": "E.g. 1000-1099",
"name": "E.g. Immateriella anläggningstillgångar",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
},
"shortTermLiabilities": {"accounts": "E.g. 1000-1099",
"name": "E.g. Immateriella anläggningstillgångar",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
},
"equityAndLiabilities": {"accounts": "E.g. 1000-1099",
"name": "E.g. Immateriella anläggningstillgångar",
"history24Mo": [{"breakDate": "2022-01-01",
"label": "2022 January",
"balance": {"amount": 100,
"currency": "SEK"
},
"change": {"amount": 100,
"currency": "SEK"
}
}
]
}
}

Income Statement

An Income Statement shows the aggregated operating income and operating costs, by pre-defined account groups.

Get income statements

Returns bundled account results for a Company.

SecurityAPIKeyAuth

Request

path Parameters

company-uuid

required

string <uuid>

Unique identifier of company

Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d

query Parameters

resultType

string

Default: "MONTHLY24"

Monthly results for the latest 24 months or aggregated rolling results per 12 months.

Enum: "MONTHLY24" "ROLLING12"

Responses

200

404

Not Found

422

Unprocessable Entity

get/companies/{company-uuid}/income-statements

Response samples

application/json

{"netSales": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"ownWorkCapitalized": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"otherOperatingIncome": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"totalRevenue": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"purchaseGoodsMaterials": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"unspecifiedAccounts": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"grossProfit": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"otherExternalOperatingExpenses": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"personnelCosts": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"ebitda": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"writeDowns": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"depreciations": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"otherOperatingExpenses": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"ebit": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"financialAndOtherIncomes": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"extraordinaryIncomeAndExpenses": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"appropriations": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"taxes": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"financialYearResult": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
},
"earningsAfterTaxes": {"accounts": "E.g. 3000-3799",
"name": "E.g. Nettoförsäljning",
"results": [{"periodStart": "2021-12-01",
"periodEnd": "2021-12-31",
"label": "2021 December",
"result": {"amount": 100,
"currency": "SEK"
}
}
]
}
}

Supplier

A supplier who has sent supplier invoice(s) to the company.

Get suppliers

Returns a list of suppliers.

SecurityAPIKeyAuth

Request

path Parameters

company-uuid

required

string <uuid>

Unique identifier of company

Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d

query Parameters

page	integer <int32> Default: 1 The paginated page number.
size	integer <int32> Default: 50 The pagination page size.

Responses

200

404

Not Found

get/companies/{company-uuid}/suppliers

Response samples

application/json

{"invoices": [{"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"name": "Monto AB",
"businessId": "559028-3601"
}
],
"meta": {"currentPage": 1,
"totalPages": 2,
"pageSize": 50
},
"links": {"first": "https://api.monto.ai/...?page=1&size=50...",
"prev": null,
"next": "https://api.monto.ai/...?page=2&size=50...",
"last": "https://api.monto.ai/...?page=1&size=50..."
}
}

Customer

A customer of the company.

Get customers

Returns a list of customers.

SecurityAPIKeyAuth

Request

path Parameters

company-uuid

required

string <uuid>

Unique identifier of company

Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d

query Parameters

page	integer <int32> Default: 1 The paginated page number.
size	integer <int32> Default: 50 The pagination page size.

Responses

200

404

Not Found

get/companies/{company-uuid}/customers

Response samples

application/json

{"invoices": [{"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"name": "Monto AB",
"businessId": "559028-3601",
"amountTotalInvoices": {"amount": 10.12,
"currency": "SEK"
},
"amountNotDueNotPaid": {"amount": 10.12,
"currency": "SEK"
},
"amountOverdueNotPaid": {"amount": 10.12,
"currency": "SEK"
},
"amountCreditedInvoices": {"amount": 10.12,
"currency": "SEK"
},
"annualRevenueShare": 10.12,
"firstTimeCustomer": true
}
],
"meta": {"currentPage": 1,
"totalPages": 2,
"pageSize": 50
},
"links": {"first": "https://api.monto.ai/...?page=1&size=50...",
"prev": null,
"next": "https://api.monto.ai/...?page=2&size=50...",
"last": "https://api.monto.ai/...?page=1&size=50..."
}
}

Customer Invoice Payment

Payments made to the Customer Invoice.

Get payments

Returns a list of payments for a customer invoice.

SecurityAPIKeyAuth

Request

path Parameters

company-uuid required	string <uuid> Unique identifier of company Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d
invoice-uuid required	string <uuid> Unique identifier of customer invoice Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d

Responses

200

404

Not Found

get/companies/{company-uuid}/customer-invoices/{invoice-uuid}/payments

Response samples

application/json

{"payments": [{"date": "2022-01-01",
"amount": {"amount": 100,
"currency": "SEK"
}
}
]
}

Customer Invoice

A record of sold goods or provided services to a Customer with a payment in demand.

Get customer invoices

Returns a list of customer invoices.

SecurityAPIKeyAuth

Request

path Parameters

company-uuid

required

string <uuid>

Unique identifier of company

Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d

query Parameters

page	integer <int32> Default: 1 The paginated page number.
size	integer <int32> Default: 50 The pagination page size.

Responses

200

404

Not Found

get/companies/{company-uuid}/customer-invoices

Response samples

application/json

{"amountTotalInvoices": {"amount": 10.12,
"currency": "SEK"
},
"amountNotDueNotPaid": {"amount": 10.12,
"currency": "SEK"
},
"amountOverdueNotPaid": {"amount": 10.12,
"currency": "SEK"
},
"creditedInvoices": true,
"prepaymentInvoices": true,
"avgPaymentTerms": 30,
"invoices": [{"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"invoiceNumber": "302",
"customer": {"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"name": "Monto AB",
"businessId": "559028-3601"
},
"amount": {"amount": 100,
"currency": "SEK"
},
"issueDate": "2019-08-24",
"dueDate": "2019-08-24",
"balance": {"amount": 100,
"currency": "SEK"
},
"connection": {"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"name": "Fortnox"
}
}
],
"meta": {"currentPage": 1,
"totalPages": 2,
"pageSize": 50
},
"links": {"first": "https://api.monto.ai/...?page=1&size=50...",
"prev": null,
"next": "https://api.monto.ai/...?page=2&size=50...",
"last": "https://api.monto.ai/...?page=1&size=50..."
}
}

Get customer invoice

Returns a single customer invoice.

SecurityAPIKeyAuth

Request

path Parameters

company-uuid required	string <uuid> Unique identifier of company Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d
invoice-uuid required	string <uuid> Unique identifier of customer invoice Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d

Responses

200

404

Not Found

get/companies/{company-uuid}/customer-invoices/{invoice-uuid}

Response samples

application/json

{"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"invoiceNumber": "302",
"customer": {"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"name": "Monto AB",
"businessId": "559028-3601"
},
"amount": {"amount": 100,
"currency": "SEK"
},
"issueDate": "2019-08-24",
"dueDate": "2019-08-24",
"balance": {"amount": 100,
"currency": "SEK"
},
"connection": {"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"name": "Fortnox"
}
}

Supplier Invoice

A record of bought goods or received services to a Supplier with a payment in demand.

Get supplier invoices

Returns a list of supplier invoices.

SecurityAPIKeyAuth

Request

path Parameters

company-uuid

required

string <uuid>

Unique identifier of company

Example: 9e0a58e5-60b5-4c15-ba2e-77b1bed4977d

query Parameters

page	integer <int32> Default: 1 The paginated page number.
size	integer <int32> Default: 50 The pagination page size.

Responses

200

404

Not Found

get/companies/{company-uuid}/supplier-invoices

Response samples

application/json

{"amountTotalInvoices": {"amount": 10.12,
"currency": "SEK"
},
"amountNotDueNotPaid": {"amount": 10.12,
"currency": "SEK"
},
"amountOverdueNotPaid": {"amount": 10.12,
"currency": "SEK"
},
"creditedInvoices": true,
"prepaymentInvoices": true,
"avgPaymentTerms": 30,
"invoices": [{"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"externalId": "6",
"invoiceNumber": "8909",
"supplier": {"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"name": "Monto AB",
"businessId": "559028-3601"
},
"amount": {"amount": 100,
"currency": "SEK"
},
"issueDate": "2019-08-24",
"dueDate": "2019-08-24",
"balance": {"amount": 100,
"currency": "SEK"
},
"connection": {"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"name": "Fortnox"
},
"paidInFullDate": "2019-08-24"
}
],
"meta": {"currentPage": 1,
"totalPages": 2,
"pageSize": 50
},
"links": {"first": "https://api.monto.ai/...?page=1&size=50...",
"prev": null,
"next": "https://api.monto.ai/...?page=2&size=50...",
"last": "https://api.monto.ai/...?page=1&size=50..."
}
}

Subscription

In order to avoid polling for changes, we allow you to register subscriptions that will notify you when certain event occurs.

Get subscriptions

Returns a list of your registered subscriptions.

SecurityAPIKeyAuth

Request

query Parameters

page	integer <int32> Default: 1 The paginated page number.
size	integer <int32> Default: 50 The pagination page size.

Responses

200

get/subscriptions

Response samples

application/json

{"subscriptions": [{"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"protocol": "HTTPS",
"endpoint": "https://api.my-service.com/webhook",
"topics": ["*"
],
"verified": true
}
],
"meta": {"currentPage": 1,
"totalPages": 2,
"pageSize": 50
},
"links": {"first": "https://api.monto.ai/...?page=1&size=50...",
"prev": null,
"next": "https://api.monto.ai/...?page=2&size=50...",
"last": "https://api.monto.ai/...?page=1&size=50..."
}
}

Create subscription

Create a new subscription.

SecurityAPIKeyAuth

Request

Request Body schema: application/json

protocol	string (SubscriptionProtocolEnum) The `protocol` of the subscription. Enum: "HTTPS" "EMAIL" "EMAIL_JSON" "SQS" "APPLICATION" "LAMBDA"
endpoint	string The endpoint of the subscription. Make sure to verify the endpoint once created.
topics	Array of strings The specified topics of the subscription. Items Enum: "*" "CONNECTION_ESTABLISHED" "CUSTOMER_INVOICE_CREATED" "CUSTOMER_INVOICE_UPDATED" "SUPPLIER_INVOICE_CREATED" "SUPPLIER_INVOICE_UPDATED"

Responses

200

422

Unprocessable Entity

post/subscriptions

Request samples

Payload

application/json

{"protocol": "HTTPS",
"endpoint": "https://api.my-service.com/webhook",
"topics": ["*"
]
}

Response samples

application/json

{"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"protocol": "HTTPS",
"endpoint": "https://api.my-service.com/webhook",
"topics": ["*"
],
"verified": true
}

Example webhook

Testing.

SecurityAPIKeyAuth

Request

Request Body schema: application/json

entityUuid	string Unique identifier for the entity.
topic	string The topic of the received event. Enum: "CONNECTION_ESTABLISHED" "CUSTOMER_INVOICE_CREATED" "CUSTOMER_INVOICE_UPDATED" "SUPPLIER_INVOICE_CREATED" "SUPPLIER_INVOICE_UPDATED"

Responses

200

posthttps://api.your-service.com/webhook

Request samples

Payload

application/json

{"entityUuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"topic": "CUSTOMER_INVOICE_CREATED"
}

Response samples

application/json

{"uuid": "9e0a58e5-60b5-4c15-ba2e-77b1bed4977d",
"protocol": "HTTPS",
"endpoint": "https://api.my-service.com/webhook",
"topics": ["*"
],
"verified": true
}