Aritma Banking API (v3)

Download OpenAPI specification:Download

Account

POST request for new bank integration

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
Request Body schema:

Update model

companyId
required
string <uuid>

Company id to associate with bankaccount

accountNumber
required
string >= 6 characters

Account number

bic
required
string

Bank identifier code

currency
string or null

Currency

ledger
string or null

Ledger

object (BankAccountAliases)
Responses
200

Returns account id. Request added for ZData approval

400

Invalid model

401

User not authorized

post/api/v3/accounts/bank
Request samples
{
  • "Bic": "DNBANOKK",
  • "Currency": "NOK",
  • "Ledger": "1920",
  • "Aliases": {
    },
  • "CompanyId": "d22b9ab7-e90c-4439-bc6f-ddcde02eea51",
  • "AccountNumber": "123456789012"
}
Response samples
No sample

Lists all accounts for a company

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id

Responses
200

A list of accounts

401

Unauthorized

404

Accounts for company not found

get/api/v3/accounts/{companyId}
Request samples
Response samples
{
  "CompanyId": "61c76bd2-c416-4cd4-b511-b9985814d484",
  "Accounts": [
    {
      "AccountId": "2cd3f2bc-af82-4f5e-b381-3ad9ddab004c",
      "AccountNumber": "123456789012",
      "Bic": "DNBANOKK",
      "Currency": "NOK",
      "AccountGroupId": "6f2ed94e-9fb6-40cf-b375-e4b667893be2",
      "Ledger": "1920",
      "Aliases": {
        "Iban": "NO22123456789012",
        "PlusGirot": "1234567",
        "BankGirot": "1234567",
        "GiroKonto": "1234567"
      },
      "ReadyForPayments": true
    }
  ]
}

Get account status for creating payments

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
bban
required
string or null

BBAN

Responses
200

The account status for creating payments

401

Unauthorized

404

Account not found

get/api/v3/accounts/{bban}/readiness
Request samples
Response samples
No sample

Get account data for a specific account in a specific company

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id

bankAccountId
required
string or null

Bank account id or bban

Responses
200

The account details

401

Unauthorized

404

Account not found

get/api/v3/accounts/{companyId}/{bankAccountId}
Request samples
Response samples
{
  "AccountId": "f2027471-2638-474b-8f9a-93b08eb5151a",
  "AccountNumber": "123456789012",
  "Bic": "DNBANOKK",
  "Currency": "NOK",
  "AccountGroupId": "34094ad9-f29c-4906-ab94-8054d89538cb",
  "Ledger": "1920",
  "Aliases": {
    "Iban": "NO22123456789012",
    "PlusGirot": "1234567",
    "BankGirot": "1234567",
    "GiroKonto": "1234567"
  }
}

Updates bankaccount

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id

bankAccountId
required
string <uuid>

Bank account id

Request Body schema:

Bank account model

bic
required
string

Bank identifier code

currency
string or null

Currency

ledger
string or null

Ledger

object (BankAccountAliases)
Responses
200

The updated account details

400

Invalid update request

401

Unauthorized

404

Account not found

put/api/v3/accounts/{companyId}/{bankAccountId}
Request samples
{
  • "Bic": "DNBANOKK",
  • "Currency": "NOK",
  • "Ledger": "1920",
  • "Aliases": {
    }
}
Response samples
{
  "AccountId": "7867d3f9-0981-440d-a62b-2e01fe5cdf4a",
  "AccountNumber": "123456789012",
  "Bic": "DNBANOKK",
  "Currency": "NOK",
  "AccountGroupId": "4ec43b01-4058-4917-9c54-5b576d533c3d",
  "Ledger": "1920",
  "Aliases": {
    "Iban": "NO22123456789012",
    "PlusGirot": "1234567",
    "BankGirot": "1234567",
    "GiroKonto": "1234567"
  }
}

Deletes an account by companyId and accountId

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id

bankAccountId
required
string <uuid>

Bank account id

Responses
200

Deleted

400

Account connected to statement, balance, receivable or payment

401

Unauthorized

403

Action not permitted for user

404

Account not found

delete/api/v3/accounts/{companyId}/{bankAccountId}
Request samples
Response samples
No sample

Changes company on bankaccount

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
bankAccountId
required
string <uuid>

Bank account id

Request Body schema:

Request with new company id

companyId
required
string <uuid>

New company id

Responses
200

Success

400

Bad Request

401

Unauthorized

404

Account not found

put/api/v3/accounts/{bankAccountId}/companySwitch
Request samples
{
  • "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda"
}
Response samples
{
  "AccountId": "3b03b153-88d7-4739-8751-bf21cf8ad24c",
  "AccountNumber": "123456789012",
  "Bic": "DNBANOKK",
  "Currency": "NOK",
  "AccountGroupId": "22483071-0607-4df1-975f-8c8f1559b58d",
  "Ledger": "1920",
  "Aliases": {
    "Iban": "NO22123456789012",
    "PlusGirot": "1234567",
    "BankGirot": "1234567",
    "GiroKonto": "1234567"
  }
}

AccountGroup

Get all account groups for company

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>
query Parameters
includeUnassociated
boolean
Default: false
includeUnassociatedDaughters
boolean
Default: false
Responses
200

Account groups for company

401

Unauthorized

403

Action not permitted for user

404

Company not found

get/api/v3/accountgroups/{companyId}
Request samples
Response samples
No sample

Get account group by AccountGroupId

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>
accountGroupId
required
string <uuid>
Responses
200

Account groups

401

Unauthorized

403

Action not permitted for user

404

Account group not found

get/api/v3/accountgroups/{companyId}/{accountGroupId}
Request samples
Response samples
No sample

Update account group name

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>
accountGroupId
required
string <uuid>
Request Body schema:
name
string or null
Responses
200
401

Unauthorized

403

Action not permitted for user

404

Account group not found

put/api/v3/accountgroups/{companyId}/{accountGroupId}
Request samples
{
  • "name": "string"
}
Response samples
No sample

Delete account group

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>
accountGroupId
required
string <uuid>
Responses
200
401

Unauthorized

403

Action not permitted for user

404

Account group not found

delete/api/v3/accountgroups/{companyId}/{accountGroupId}
Request samples
Response samples
No sample

Post new account group

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
Request Body schema:
companyId
string <uuid>
name
string or null
Responses
200
401

Unauthorized

403

Action not permitted for user

404

Company not found

post/api/v3/accountgroups
Request samples
{
  • "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda",
  • "name": "string"
}
Response samples
No sample

Add user to account group

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>
accountGroupId
required
string <uuid>
Request Body schema:
id
string <uuid>
Responses
200
401

Unauthorized

403

Action not permitted for user

404

User/Account group not found

post/api/v3/accountgroups/{companyId}/{accountGroupId}/user
Request samples
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
Response samples
No sample

Remove user from account group

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>
accountGroupId
required
string <uuid>
userId
required
string <uuid>
Responses
200
401

Unauthorized

403

Action not permitted for user

404

User/Account group not found

delete/api/v3/accountgroups/{companyId}/{accountGroupId}/user/{userId}
Request samples
Response samples
No sample

Add account to account group

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>
accountGroupId
required
string <uuid>
Request Body schema:
id
string <uuid>
Responses
200
401

Unauthorized

403

Action not permitted for user

404

AccountGroup/Account not found

post/api/v3/accountgroups/{companyId}/{accountGroupId}/account
Request samples
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
Response samples
No sample

Remove account from account group

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>
accountGroupId
required
string <uuid>
accountId
required
string <uuid>
Responses
200
401

Unauthorized

403

Action not permitted for user

404

AccountGroup/Account not found

delete/api/v3/accountgroups/{companyId}/{accountGroupId}/account/{accountId}
Request samples
Response samples
No sample

Balance

Get balance for account.

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company Id

account
required
string or null

Account number

query Parameters
date
string or null <date-time>

Date (yyyy-mm-dd). Returns balance. When no balance, returns the nearest older balance.

dateSwitch
boolean
Default: false

False, same as above. When True , Returns balance. When no balance, returns the nearest newer balance.

Responses
200

Success

400

Invalid state

401

User not authorized

404

Balance not found

get/api/v3/balances/{companyId}/{account}
Request samples
Response samples
No sample

Company

Gets details for all valid companies

Subject to change. Data may be migrated to another API

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
query Parameters
state
integer <int32> (CompanyState)

Optional state filter

Enum: 0 1 2 999
Responses
200

Flat list of valid companies

get/api/v3/companies
Request samples
Response samples
No sample

Create new company

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
Request Body schema:

Company model

organizationNumber
required
string

Company organization number. If matched in Brønnøysund, company name and adress will be overwritten

companyId
string or null <uuid>

Desired company id (optional)

parentCompanyId
string or null <uuid>

Id of parent company. Can be used to request subsidiary status for company.

name
string or null

Company name. Mandatory for companies outside Norway

address
string or null

Company address

zipCode
string or null

Company zipcode

zipArea
string or null

Company zip area

country
string or null

Company country required if company is not found in The Brønnøysund Register. Mandatory for companies outside Norway

Responses
200

"Company id"

401

Unauthorized

403

User not authorized for parent company

404

Not Found

post/api/v3/companies
Request samples
{
  • "CompanyId": "427312d9-0d61-4601-80ff-29791bfb077b",
  • "Name": "Duck corp",
  • "Address": "Apalveien 222",
  • "ZipCode": "0010",
  • "ZipArea": "Oslo",
  • "Country": "Norway"
}
Response samples
No sample

Gets company details

Subject to change. Data may be migrated to another API

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id

Responses
200

Company dto

401

Unauthorized

404

Company not found

get/api/v3/companies/{companyId}
Request samples
Response samples
{
  "Name": "Z Data AS",
  "Address": "Damsgårdsveien 167",
  "ZipCode": "5160",
  "ZipArea": "Laksevåg",
  "Country": "Norge",
  "OrganizationNumber": "976197976",
  "CompanyId": "8d5dda81-1444-4559-9451-68b13e09895f",
  "State": 1
}

Deactivate company

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id

Responses
200

"Company id"

401

Unauthorized

404

Company not found

delete/api/v3/companies/{companyId}
Request samples

Gets company subsidiaries

Subject to change. Data may be migrated to another API

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id

Responses
200

Subsidiary dto's

401

Unauthorized

404

Company not found

get/api/v3/companies/{companyId}/subsidiaries
Request samples
Response samples
No sample

Gets company users

Subject to change. Data may be migrated to another API

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id

Responses
200

"Company id"

401

Unauthorized

404

Company not found

get/api/v3/companies/{companyId}/users
Request samples
Response samples
No sample

EventGridDeadLetter

Get dead letter event

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
eventId
required
string <uuid>
Responses
200

Success

401

Unauthorized

404

Dead letter event not found

get/api/v3/events/deadletters/{eventId}
Request samples
Response samples
No sample

Delete dead letter event

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
eventId
required
string <uuid>
Responses
200

Success

404

Dead letter event not found

delete/api/v3/events/deadletters/{eventId}
Request samples

Get list of dead letter event metadata for client

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
query Parameters
skip
integer or null <int32>

Number of entries to skip

take
integer or null <int32>

Number of entries to return

Responses
200

Success

404

No dead letter events found for client

get/api/v3/events/deadletters
Request samples
Response samples
No sample

Get list of dead letter event metadata for company

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id

query Parameters
skip
integer or null <int32>

Number of entries to skip

take
integer or null <int32>

Number of entries to return

Responses
200

Success

401

Unauthorized

404

No dead letter events found for company

get/api/v3/events/companies/{companyId}/deadletters
Request samples
Response samples
No sample

Get list of dead letter event metadata for subscription

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id

subscriptionName
required
string or null

Subscription name

query Parameters
skip
integer or null <int32>

Number of entries to skip

take
integer or null <int32>

Number of entries to return

Responses
200

Success

401

Unauthorized

404

No dead letter events found for subscription

get/api/v3/events/companies/{companyId}/subscriptions/{subscriptionName}/deadletters
Request samples
Response samples
No sample

EventGridSubscription

Get event subscriptions for company

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id

query Parameters
skip
integer or null <int32>

Number of entries to skip

take
integer or null <int32>

Number of entries to return

Responses
200

Success

401

Unauthorized

get/api/v3/companies/{companyId}/subscriptions
Request samples
Response samples
No sample

Get subscription.

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id.

subscriptionName
required
string or null

Subscription name (only A-Z a-z 0-9 and "-") (3-64 characters).

Responses
200

Success

400

Bad request

401

Unauthorized

404

Subscription not found

get/api/v3/companies/{companyId}/subscriptions/{subscriptionName}
Request samples
Response samples
No sample

Create or update event subscription.

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id.

subscriptionName
required
string or null

Subscription name (only A-Z a-z 0-9 and "-") (3-64 characters).

Request Body schema:

Event subscription.

eventTypes
Array of strings or null
object (EventSubscriptionDestination)
Responses
200

Success

400

Bad request

401

Unauthorized

put/api/v3/companies/{companyId}/subscriptions/{subscriptionName}
Request samples
{
  • "eventTypes": [
    ],
  • "destination": {
    }
}
Response samples
No sample

Delete event subscription

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id.

subscriptionName
required
string or null

Subscription name (only A-Z a-z 0-9 and "-") (3-64 characters).

Responses
200

Success

400

Bad request

401

Unauthorized

404

Event subscription not found

delete/api/v3/companies/{companyId}/subscriptions/{subscriptionName}
Request samples

CreateEventGridSubscriptionBatch

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
subscriptionName
required
string or null
query Parameters
skip
integer or null <int32>
take
integer or null <int32>
Request Body schema:
companyIds
Array of strings or null
eventTypes
Array of strings or null
object (EventSubscriptionDestination)
Responses
200

Success

put/api/v3/subscriptions/{subscriptionName}
Request samples
{
  • "companyIds": [
    ],
  • "eventTypes": [
    ],
  • "destination": {
    }
}
Response samples
No sample

Onboarding

Returns an onboarding instruction on for the provided BIC

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
bic
required
string or null

The bank's BIC code

query Parameters
languageCode
string or null
Default: "NO"

Language code (EN, NO, SE, DK, etc), defaults to NO

payments
boolean
Default: false

Include onboarding info for payments (if applicable)

receivables
boolean
Default: false

Include onboarding info for receivables (if applicable)

statements
boolean
Default: false

Include onboarding info for statements (if applicable)

balances
boolean
Default: false

Include onboarding info for balances (if applicable)

Responses
200

Onboarding instructions as HTML

400

Invalid grant type/client

get/api/v3/onboarding/{bic}
Request samples
Response samples
No sample

Get whether approval requirement is activated on account

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
account
required
string or null

Account number

Responses
200

Success

401

User not authorized

404

Account not found

get/api/v3/onboarding/preapproval/{account}
Request samples
Response samples
No sample

Payment

Get payments by messageId

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
messageId
required
string or null

Payment message id filter

query Parameters
skip
integer <int32>
Default: 0

Pagination: Number to skip (default 0)

take
integer <int32>
Default: 100

Pagination: Max number to return (default 100)

Responses
200

Success

401

User not authorized

404

Invalid messageId

get/api/v3/payments/{messageId}
Request samples
Response samples
{
  "Payments": [
    {
      "PaymentId": "f5e0c8f7-5226-4d3e-8b8d-fae3882ef89f",
      "SourceReference": "100;101;22;6",
      "Status": 6,
      "ExecutionDate": "0001-01-01T00:00:00",
      "Links": [
        {
          "Rel": "payment",
          "Href": "https://bankservice.zdata.no/api/v3/payments/8043f884-0a70-40f9-9e57-58347102412a/c4dc6968-5161-4666-bd21-cee1a3c3ea72"
        }
      ]
    }
  ],
  "Total": 15,
  "Links": [
    {
      "Rel": "first",
      "Href": "https://bankservice.zdata.no/api/v3/payments/8043f884-0a70-40f9-9e57-58347102412a?skip=0&take=100"
    }
  ]
}

Get payments by batchId

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Unique Guid for company

batchId
required
string <uuid>

Unique Guid for the batch

query Parameters
skip
integer <int32>
Default: 0

Number of entries to skip

take
integer <int32>
Default: 100

Number of entries to return

Responses
200

Success

401

User not authorized

404

Invalid messageId

get/api/v3/payments/{companyId}/batches/{batchId}/transactions
Request samples
Response samples
{
  "Payments": [
    {
      "PaymentId": "f9a930a6-2a06-45e3-a85b-50ad9f4fa816",
      "SourceReference": "100;101;22;6",
      "Status": 6,
      "ExecutionDate": "0001-01-01T00:00:00",
      "Links": [
        {
          "Rel": "payment",
          "Href": "https://bankservice.zdata.no/api/v3/payments/8043f884-0a70-40f9-9e57-58347102412a/c4dc6968-5161-4666-bd21-cee1a3c3ea72"
        }
      ]
    }
  ],
  "Total": 15,
  "Links": [
    {
      "Rel": "first",
      "Href": "https://bankservice.zdata.no/api/v3/payments/8043f884-0a70-40f9-9e57-58347102412a?skip=0&take=100"
    }
  ]
}

Get payment lines by batchId

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Unique Guid for company

batchId
required
string <uuid>

Unique Guid for the batch

query Parameters
skip
integer <int32>
Default: 0

Number of entries to skip

take
integer <int32>
Default: 10000

Number of entries to return

Responses
200

Success

401

User not authorized

404

Invalid messageId

get/api/v3/payments/{companyId}/batches/{batchId}
Request samples
Response samples
No sample

Get payment by sourceReference

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
messageId
required
string <uuid>

The unique id for the remittance

paymentId
required
string <uuid>

Payment id of payment line

Responses
200

Success

401

User not authorized

404

Invalid messageId

get/api/v3/payments/{messageId}/{paymentId}
Request samples
Response samples
{
  "PaymentId": "90d9b2ce-7cd1-4fb0-a1fc-f9d0564c83c1",
  "Status": 0,
  "RejectionCode": "RR09",
  "RejectionMessage": "ISO Invalid Structured Creditor Reference",
  "Amount": 50,
  "Currency": "NOK",
  "ExecutionDate": "0001-01-01T00:00:00",
  "CreditorName": "Kreditor AS",
  "CreditorAccountNumber": "123456789012",
  "CreditorAccountCurrency": "NOK",
  "ChargeAmount": 70,
  "ChargeCurrency": "NOK",
  "Description": "Invoice number 32",
  "InvoiceNumber": "Something",
  "Settlement": {
    "BookingDate": "2024-07-27T00:09:24.1763359+02:00",
    "ValueDate": "2024-07-27T00:09:24.1763363+02:00",
    "ExchangeRate": 1.2,
    "Reference": "12345"
  }
}

Get summary of payments for company

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Unique Guid for company

query Parameters
state
integer <int32> (TransactionState)

Transaction state

Enum: 0 1 2 3 4 5 6 7 8
fromDate
string or null <date-time>

Earliest date to be included

toDate
string or null <date-time>

Latest date to be included

skip
integer or null <int32>

Number of entries to skip

take
integer or null <int32>

Number of entries to return

Responses
200

Success

401

User not authorized

404

Invalid companyId

get/api/v3/payments/{companyId}/summaries
Request samples
Response samples
{
  "Summaries": [
    {
      "MessageId": "8a21eef1-8476-487b-81fb-aece3d01064f",
      "Timestamp": "2024-07-27T00:09:24.179028+02:00",
      "FirstExecutionDate": "2024-07-27T00:09:24.179026+02:00",
      "LastExecutionDate": "2024-07-27T00:09:24.1790264+02:00",
      "Amounts": {
        "NOK": 55
      },
      "Links": [
        {
          "Rel": "payments",
          "Href": "https://bankservice.zdata.no/api/v3/payments/0a8f02d5-24e1-4ea5-be46-135c2fa4f8c9"
        }
      ]
    }
  ],
  "Total": 0
}

Gets booked payments for company

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Unique Guid for company

query Parameters
accountNumber
string or null

Bank account number

fromDate
string or null <date-time>

Earliest date to be included

toDate
string or null <date-time>

Latest date to be included

skip
integer or null <int32>

Number of entries to skip

take
integer or null <int32>

Number of entries to return

sourceReference
string or null

Source reference of a payment. When included, all payments within the same payment bundle will be returned

Responses
200

Success

401

User not authorized

404

Invalid messageId/sourceReference

get/api/v3/payments/{companyId}/movements
Request samples
Response samples
{
  "BookedPayments": [
    {
      "BookedAmount": 55,
      "AccountCurrency": "NOK",
      "ExchangeRate": 0,
      "BookingDate": "2024-07-27T00:09:24.1826821+02:00",
      "BankReference": "123321",
      "ChargeAmount": 66,
      "ChargeCurrency": "NOK",
      "Payments": [
        {
          "PaymentId": "00000000-0000-0000-0000-000000000000",
          "MessageId": "00000000-0000-0000-0000-000000000000",
          "Links": [
            {
              "Rel": "payment",
              "Href": "http://bankservice.zdata.no/api/v3/payments/5cfd18e2-f37b-4d67-9661-f897b152d459/d0bde9d1-569d-4f5c-aaa7-f8197631fe23"
            }
          ]
        }
      ]
    }
  ],
  "Total": 0
}

Gets booked payments for settlement

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Unique Guid for company

batchId
required
string <uuid>

Unique Guid for the batch

query Parameters
skip
integer or null <int32>

Number of entries to skip

take
integer or null <int32>

Number of entries to return

Responses
200

Success

401

User not authorized

404

Invalid companyId/settlementId

get/api/v3/payments/{companyId}/batches/{batchId}/movements
Request samples
Response samples
{
  "BookedPayments": [
    {
      "BookedAmount": 55,
      "AccountCurrency": "NOK",
      "ExchangeRate": 0,
      "BookingDate": "2024-07-27T00:09:24.1837504+02:00",
      "BankReference": "123321",
      "ChargeAmount": 66,
      "ChargeCurrency": "NOK",
      "Payments": [
        {
          "PaymentId": "00000000-0000-0000-0000-000000000000",
          "MessageId": "00000000-0000-0000-0000-000000000000",
          "Links": [
            {
              "Rel": "payment",
              "Href": "http://bankservice.zdata.no/api/v3/payments/5cfd18e2-f37b-4d67-9661-f897b152d459/d0bde9d1-569d-4f5c-aaa7-f8197631fe23"
            }
          ]
        }
      ]
    }
  ],
  "Total": 0
}

Dismiss payments

Tokens provided to this endpoint must use implicit or authorization code grant type flows.

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
messageId
required
string <uuid>

The unique id for the payments

Request Body schema:

Rejection message

reason
string or null

Reason for rejection

Responses
200

Success

400

Already approved, Missing access to bankaccounts

401

User not authorized

404

Remittance not found

put/api/v3/payments/{messageId}/dismiss
Request samples
{
  • "reason": "string"
}
Response samples
No sample

Approves payments by message id.

Tokens provided to this endpoint must use implicit or authorization code grant type flows.

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
messageId
required
string <uuid>

The unique id for the payments

Responses
200

Success

400

Already reviewed, Payments were approved

401

User not authorized

404

Remittance not found

put/api/v3/payments/{messageId}/approve
Request samples
Response samples
No sample

Get payment approval data

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
messageId
required
string or null

Payment message id filter

Responses
200

Success

401

User not authorized

404

Invalid messageId

get/api/v3/payments/{messageId}/approve
Request samples
Response samples
No sample

Submits payments for an account. <br>The AccountNumber MUST be owned by the company and in an account group that the user has access to.

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>
Request Body schema:
messageId
required
string <uuid>
accountNumber
required
string
singlePayments
boolean

Always send single payments to creditor. This will not work with credit notes.

required
Array of objects (PaymentLine)
Responses
200

Success

post/api/v3/payments/{companyId}
Request samples
{
  • "MessageId": "ba65c481-f2ff-43ff-bbef-f117e6727921",
  • "AccountNumber": "52011976166",
  • "SinglePayments": false,
  • "PaymentLines": [
    ]
}
Response samples
No sample

Receivable

Get incoming payments

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company Id

state
required
integer <int32> (InpaymentState)

Receivable state filter

Enum: 0 1 2
query Parameters
account
string or null

Account filter (optional)

fromDate
string or null <date-time>

Time frame limitation

toDate
string or null <date-time>

Time frame limitation

take
integer <int32>
Default: 100

Pagination: Max number to return (default 100)

skip
integer <int32>
Default: 0

Pagination: Number to skip (default 0)

Responses
200

Success

400

"Invalid state"

401

User not authorized

get/api/v3/receivables/{companyId}/{state}
Request samples
Response samples
{
  "State": 0,
  "Receivables": [
    {
      "ReceivableId": "97a486ec-61da-42f1-9d48-04f3421bea98",
      "EntryId": "80a6b241-e4f2-4fff-8fb2-76e44a845307",
      "AccountNumber": "123456789012",
      "DebtorAccountNumber": "098765432112",
      "DebtorName": "Donald Duck",
      "DebtorAddress": "Veien 12A",
      "ArchiveReference": "1234",
      "Description": "Submitted to Onkel Skrue",
      "InvoiceNumber": "12345",
      "BookingDate": "2024-07-27T00:09:24.1989219+02:00",
      "ValueDate": "2024-07-27T00:09:24.1989245+02:00",
      "Amount": 55,
      "Currency": "NOK",
      "BookedAmount": 65,
      "AccountCurrency": "NOK",
      "ChargeAmount": 10,
      "ChargeCurrency": "NOK",
      "Type": 0,
      "BankTransactionCode": "PMNT-ICDT-DMCT"
    }
  ],
  "Total": 0
}

Get receivables for a given file. Only valid with client credentials flow

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company Id

batchId
required
string <uuid>

Batch id

query Parameters
take
integer <int32>
Default: 100

Pagination: Max number to return (default 100)

skip
integer <int32>
Default: 0

Pagination: Number to skip (default 0)

Responses
200

Success

401

User not authorized

404

Id not found

get/api/v3/receivables/{companyId}/batches/{batchId}/transactions
Request samples
Response samples
{
  "TotalCount": 1,
  "Skip": 0,
  "Take": 10,
  "Items": [
    {
      "ReceivableId": "f8329c4b-dac8-4517-849f-37f29939ef40",
      "EntryId": "8b26fce6-e249-4f2e-a9a2-52a6e9281782",
      "AccountNumber": "123456789012",
      "DebtorAccountNumber": "098765432112",
      "DebtorName": "Donald Duck",
      "DebtorAddress": "Veien 12A",
      "ArchiveReference": "1234",
      "Description": "Submitted to Onkel Skrue",
      "InvoiceNumber": "12345",
      "BookingDate": "2024-07-27T00:09:24.2005268+02:00",
      "ValueDate": "2024-07-27T00:09:24.2005293+02:00",
      "Amount": 55,
      "Currency": "NOK",
      "BookedAmount": 65,
      "AccountCurrency": "NOK",
      "ChargeAmount": 10,
      "ChargeCurrency": "NOK",
      "Type": 0,
      "BankTransactionCode": "PMNT-ICDT-DMCT"
    }
  ]
}

Change state of all receivables in batch.

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company Id

batchId
required
string <uuid>

Batch id

Request Body schema:
state
integer <int32> (InpaymentState)

InpaymentState

  • 0 - Queued
  • 1 - Transferred
  • 2 - Error
Enum: 0 1 2
errorMessage
string or null

Error message (used if State is set to Error)

Responses
200

Success

401

User not authorized

404

Id not found

put/api/v3/receivables/{companyId}/batches/{batchId}
Request samples
{
  • "state": 0,
  • "errorMessage": "string"
}

Update transaction state

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
Request Body schema:

Update model

state
required
integer <int32> (InpaymentState)

InpaymentState

  • 0 - Queued
  • 1 - Transferred
  • 2 - Error
Enum: 0 1 2
errorMessage
string or null

Error message (used if State is set to Error)

id
required
string <uuid>

Inpayment Id

Responses
200

Updated states

400

"Invalid model"

401

User not authorized

404

Incoming payment id not found

post/api/v3/receivables/update
Request samples
{
  • "State": 2,
  • "ErrorMessage": "Something failed",
  • "Id": "c062a8b2-354f-4e90-af89-d53b68590f44"
}
Response samples
{
  "State": 0,
  "Receivables": [
    {
      "ReceivableId": "bf514cd6-d685-4b8f-b7a6-35c96f39acf3",
      "EntryId": "1e8d01e9-265d-4048-9f9c-cc401e04d5db",
      "AccountNumber": "123456789012",
      "DebtorAccountNumber": "098765432112",
      "DebtorName": "Donald Duck",
      "DebtorAddress": "Veien 12A",
      "ArchiveReference": "1234",
      "Description": "Submitted to Onkel Skrue",
      "InvoiceNumber": "12345",
      "BookingDate": "2024-07-27T00:09:24.2028412+02:00",
      "ValueDate": "2024-07-27T00:09:24.2028435+02:00",
      "Amount": 55,
      "Currency": "NOK",
      "BookedAmount": 65,
      "AccountCurrency": "NOK",
      "ChargeAmount": 10,
      "ChargeCurrency": "NOK",
      "Type": 0,
      "BankTransactionCode": "PMNT-ICDT-DMCT"
    }
  ],
  "Total": 0
}

Recipients

Lists all payments recipients for a company

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company identification

Responses
200

A list of recipients

401

Unauthorized

404

Recipients for company not found

get/api/v3/receipt/suppliernotification/{companyId}
Request samples
Response samples
No sample

Create new recipient

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>
Request Body schema:
name
string or null
accountNumber
string or null
email
string or null
Responses
200
401

Unauthorized

403

Action not permitted for user

404

Recipients for company not found

post/api/v3/receipt/suppliernotification/{companyId}
Request samples
{
  • "name": "string",
  • "accountNumber": "string",
  • "email": "string"
}
Response samples
No sample

Update recipient

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id

recipientId
required
integer <int32>

Id of recipient

Request Body schema:

Update model

name
string or null
accountNumber
string or null
email
string or null
Responses
200
401

Unauthorized

403

Action not permitted for user

404

Recipient not found

put/api/v3/receipt/suppliernotification/{companyId}/{recipientId}
Request samples
{
  • "name": "string",
  • "accountNumber": "string",
  • "email": "string"
}
Response samples
No sample

Delete recipient

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>
recipientId
required
integer <int32>
Responses
200
401

Unauthorized

403

Action not permitted for user

404

Recipient not found

delete/api/v3/receipt/suppliernotification/{companyId}/{recipientId}
Request samples
Response samples
No sample

Services

POST request for new bank integration

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
Request Body schema:

Model

companyId
required
string <uuid>

Company id to register associate with service

bic
required
string

Bank identifier code

bankApproval
boolean
Responses
200

Returns service id. Request added for ZData approval

400

Unknown BIC, contact ZData to have this bank added

401

User not authorized

post/api/v3/services/bank
Request samples
{
  • "CompanyId": "73889245-4718-4149-ac99-29124fdffa89",
  • "Bic": "DNBANOKK",
  • "BankApproval": true
}
Response samples
No sample

Gets company services

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id

query Parameters
state
integer <int32> (BankServiceState)

Optional state filter

Enum: 0 1 2 3 4 5
Responses
200

Service dto's

400

Bad Request

401

Unauthorized

get/api/v3/services/bank/{companyId}
Request samples
Response samples
No sample

Gets company service

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Company id

serviceId
required
string <uuid>

Service id

Responses
200

Service dto

400

Bad Request

401

Unauthorized

404

Service not found

get/api/v3/services/bank/{companyId}/{serviceId}
Request samples
Response samples
{
  "Id": "3f492088-30ab-4bdb-9402-7d59ba039c39",
  "CompanyId": "115035f8-03d8-4e41-a6c9-8cada8284f2a",
  "Name": "Agreenet for Donal Duck",
  "State": 0,
  "BIC": "DNBANOKK",
  "Created": "2024-07-27T00:09:24.2121721+02:00"
}

Statement

Returns bank statements for a given company. All statements are given in aggregated form, to get detailed transactions use the transactions link

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>
query Parameters
accountNo
string or null
Default: ""

Optional filtering on account number

fromDate
string or null <date-time>

Timeframe limitation, must be provided together with toDate

toDate
string or null <date-time>

Timeframe limitation, must be provided together with fromDate

state
integer <int32> (BankStatementState)

Optional filtering on transaction state, state can be used to avoid downloading statements twice, use state link (PUT) to set state

Enum: 0 1 2
Responses
200

Success

400

Invalid account number or date format

401

User not authorized

404

Statements not found for this company

get/api/v3/statements/{companyId}
Request samples
Response samples
{
  "Statements": [
    {
      "StatementId": "214fbefe-74ab-42c8-b4b9-0fe015046348",
      "Name": "Donal Duck",
      "AccountNumber": "123456789012",
      "AccountCurrency": "NOK",
      "ArchiveReference": "121212",
      "BankInformation": "NO124123 23123",
      "StructuredReference": "123123",
      "Amount": 55,
      "AmountCurrency": "NOK",
      "Description": "Description",
      "BookingDate": "2024-07-27T00:09:24.2161446+02:00",
      "ValueDate": "2024-07-27T00:09:24.2161476+02:00",
      "BankTransactionCodes": "PMNT-ICDT-DMCT",
      "EntryReference": "123123",
      "TransactionCount": 1,
      "Links": [
        {
          "Rel": "details",
          "Href": "https://bankservicedemo.zdata.no/api/v3/statements/c32e6b5b-ca63-48d0-91ab-d5c6cb781737/7eeda2b9-e57e-49e3-8591-f3fc2cad2cd7/transactions"
        },
        {
          "Rel": "state",
          "Href": "https://bankservicedemo.zdata.no/api/v3/statements/c32e6b5b-ca63-48d0-91ab-d5c6cb781737/7eeda2b9-e57e-49e3-8591-f3fc2cad2cd7/state"
        }
      ]
    }
  ]
}

Returns bank statements for a given id in aggregated form. To get detailed transactions use the transactions link

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

The company id

entryId
required
string <uuid>

The entry id

Responses
200

Success

400

Bad Request

401

User not authorized

404

Statements not found for this company

get/api/v3/statements/{companyId}/entries/{entryId}
Request samples
Response samples
{
  "StatementId": "d04c2bda-300a-48d9-91c8-f41c0c6fb955",
  "Name": "Donal Duck",
  "AccountNumber": "123456789012",
  "AccountCurrency": "NOK",
  "ArchiveReference": "121212",
  "BankInformation": "NO124123 23123",
  "StructuredReference": "123123",
  "Amount": 55,
  "AmountCurrency": "NOK",
  "Description": "Description",
  "BookingDate": "2024-07-27T00:09:24.217498+02:00",
  "ValueDate": "2024-07-27T00:09:24.2175011+02:00",
  "BankTransactionCodes": "PMNT-ICDT-DMCT",
  "EntryReference": "123123",
  "TransactionCount": 1,
  "Links": [
    {
      "Rel": "details",
      "Href": "https://bankservicedemo.zdata.no/api/v3/statements/c32e6b5b-ca63-48d0-91ab-d5c6cb781737/7eeda2b9-e57e-49e3-8591-f3fc2cad2cd7/transactions"
    },
    {
      "Rel": "state",
      "Href": "https://bankservicedemo.zdata.no/api/v3/statements/c32e6b5b-ca63-48d0-91ab-d5c6cb781737/7eeda2b9-e57e-49e3-8591-f3fc2cad2cd7/state"
    }
  ]
}

Returns all transactions for a given statement.Deprecated

Renamed to /{companyId}/entries/{entryId}/transactions

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Id of company that owns the statement

statementId
required
string <uuid>

Unique StatementId

Responses
200

Success

get/api/v3/statements/{companyId}/{statementId}/transactions
Request samples
Response samples
{
  "StatementId": "0f537567-72ac-4bd3-b0c1-1db3fe76a1a9",
  "Transactions": [
    {
      "StatementId": "54e8953e-b112-431f-b727-db33cfcc1f69",
      "Name": "Some name",
      "AccountNumber": "1233456",
      "AccountCurrency": "NOK",
      "ArchiveReference": "12345677",
      "BankInformation": "123123",
      "StructuredReference": "31231231",
      "Amount": 56,
      "AmountCurrency": "NOK",
      "Description": "Description",
      "BookingDate": "2024-07-27T00:09:24.2219126+02:00",
      "BankTransactionCodes": "PMNT-ICDT-DMCT",
      "Type": "Debit",
      "TransactionId": "4f0b7e6f-9c50-408c-b180-952716c6b97d",
      "InvoiceNumber": "123345",
      "ReceiverName": "Donald Duck",
      "ReceiverAccount": "123445678978",
      "SenderName": "Dolly Duck",
      "SenderAccount": "098765432112",
      "UnstructuredText": {
        "Ustrd": [],
        "AddtlTxInf": [],
        "InstrId": [
          "InstrId A, InstrId B"
        ],
        "PrtryCd": [],
        "AddtlNtryInf": [
          "AddtlNtryInf Text"
        ]
      }
    }
  ]
}

Returns all transactions for a given statement.

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Id of company that owns the statement

entryId
required
string <uuid>

Unique statement entry id

Responses
200

Success

get/api/v3/statements/{companyId}/entries/{entryId}/transactions
Request samples
Response samples
{
  "StatementId": "79e93f50-a96b-40bb-974e-c2cc4ac7a8c3",
  "Transactions": [
    {
      "StatementId": "ed44c9e3-00f0-4e9d-9555-7f122179a8f6",
      "Name": "Some name",
      "AccountNumber": "1233456",
      "AccountCurrency": "NOK",
      "ArchiveReference": "12345677",
      "BankInformation": "123123",
      "StructuredReference": "31231231",
      "Amount": 56,
      "AmountCurrency": "NOK",
      "Description": "Description",
      "BookingDate": "2024-07-27T00:09:24.2225867+02:00",
      "BankTransactionCodes": "PMNT-ICDT-DMCT",
      "Type": "Debit",
      "TransactionId": "a580d3c4-f22b-44ba-82e7-cd189872e8c1",
      "InvoiceNumber": "123345",
      "ReceiverName": "Donald Duck",
      "ReceiverAccount": "123445678978",
      "SenderName": "Dolly Duck",
      "SenderAccount": "098765432112",
      "UnstructuredText": {
        "Ustrd": [],
        "AddtlTxInf": [],
        "InstrId": [
          "InstrId A, InstrId B"
        ],
        "PrtryCd": [],
        "AddtlNtryInf": [
          "AddtlNtryInf Text"
        ]
      }
    }
  ]
}

Updates state of all transactions for a given statement.

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
companyId
required
string <uuid>

Id of company that owns the statement

statementId
required
string <uuid>

Unique StatementId

Request Body schema:

Update request

state
required
integer <int32> (BankStatementState)

BankStatementState

  • 0 - Created
  • 1 - Transferred
  • 2 - Error
Enum: 0 1 2
errorMessage
string or null

Error message (used if State is set to Error)

Responses
200

Success

put/api/v3/statements/{companyId}/{statementId}/state
Request samples
{
  • "state": 0,
  • "errorMessage": "string"
}
Response samples
No sample

User

Gets user details

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
path Parameters
userId
required
string <uuid>

User id

Responses
200

Success

401

Unauthorized

404

User not found

get/api/v3/users/{userId}
Request samples
Response samples
{
  "Id": "123321123",
  "CompanyId": "e7552b1b-f99f-4323-a5fa-14883fbca66c",
  "Username": "duck@duck.com",
  "Email": "duck@duck.com",
  "Name": "Duck corp",
  "PhoneNumber": "52 52 52 52",
  "ActiveUser": true
}

POST new user

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
Request Body schema:

Update model

companyId
required
string <uuid>

Company id to associate with user

username
required
string

Username

email
required
string <email>

Users email

name
required
string

Name

phoneNumber
required
string

Phone number

password
string or null

Password (optional), if not set user will receive email to complete registration

Responses
200

User created

202

User created, but failed to set password

400

Bad Request

401

User not authorized

404

Company not found

post/api/v3/users
Request samples
{
  • "companyId": "c32e6b5b-ca63-48d0-91ab-d5c6cb781737",
  • "username": "user1@mycompany.com",
  • "email": "user1@mycompany.com",
  • "name": "Ola Nordmann",
  • "phoneNumber": "90001337",
  • "password": "sdf35asty4q3g5ehgg%¤"
}
Response samples
No sample

Sends mail to user for password reset

Securityclient_credentials or implicit or client_credentials_dev or implicit_dev
Request
Request Body schema:

Model for password reset

username
required
string

Username

Responses
200

Success

post/api/v3/users/resetpassword
Request samples
{
  • "Username": "myusername"
}