Accounting Link API — connect accounting providers

Accounting Link connects your Borga account to your accounting software so that invoices, credit notes, and payments sync automatically. Borga supports both OAuth-based providers (which redirect users through an authorization flow) and form-based providers (where you supply credentials directly). Once connected, you can map VAT codes and GL accounts to control how transactions are posted.

For a step-by-step walkthrough of setting up an accounting integration, see the Accounting Link setup guide.

List providers

GET /v1/accounting_link/providers Returns a list of available accounting providers and their connection methods.

curl --request GET \
  --url https://api.borga.is/v1/accounting_link/providers \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx"

Response fields

object[]

required

Array of provider objects.

Show provider fields

string

required

Provider identifier (e.g. xero, quickbooks, dynamics).

string

required

Display name of the provider.

string

required

Authentication method: oauth or form.

{
  "data": [
    {
      "id": "xero",
      "name": "Xero",
      "auth_type": "oauth"
    },
    {
      "id": "dynamics",
      "name": "Microsoft Dynamics",
      "auth_type": "form"
    }
  ]
}

Start a connection

POST /v1/accounting_link/connect Initiates a connection to an accounting provider. For OAuth providers, the response includes a redirect_url — send the user there to authorize the connection. For form-based providers, use complete a connection instead.

Request parameters

string

required

The provider ID to connect to (e.g. xero, quickbooks).

string

The mode to connect in. One of test or live. Defaults to live.

curl --request POST \
  --url https://api.borga.is/v1/accounting_link/connect \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx" \
  --header "Content-Type: application/json" \
  --data '{
    "provider": "xero",
    "mode": "live"
  }'

Response fields

string

The OAuth authorization URL to redirect the user to. Present for OAuth providers only.

{
  "redirect_url": "https://login.xero.com/identity/connect/authorize?..."
}

Complete a connection

POST /v1/accounting_link/complete Completes a form-based provider connection by submitting credentials directly. Not applicable to OAuth providers.

Request parameters

string

required

The provider ID to connect to.

object

required

Provider-specific credential fields. Refer to your accounting provider’s API documentation for the required fields.

curl --request POST \
  --url https://api.borga.is/v1/accounting_link/complete \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx" \
  --header "Content-Type: application/json" \
  --data '{
    "provider": "dynamics",
    "credentials": {
      "client_id": "...",
      "client_secret": "...",
      "tenant_id": "..."
    }
  }'

Response fields

Returns the created AccountingLink object. See get current link for the full field reference.

{
  "id": "alink_01hx9z3k2mfq7nbvd4cw8ej5rt",
  "provider": "dynamics",
  "status": "active",
  "mode": "live",
  "created_at": "2026-04-29T10:15:00Z"
}

OAuth callback

GET /v1/accounting_link/callback/{provider} OAuth providers redirect to this endpoint after the user authorizes access. Borga handles the token exchange automatically — you do not need to call this endpoint directly. It is documented here for reference if you need to configure a redirect URI in your OAuth provider’s settings.

Path parameters

string

required

The provider completing the OAuth flow (e.g. xero).

Get current link

GET /v1/accounting_link Returns the current accounting provider connection for your merchant account.

curl --request GET \
  --url https://api.borga.is/v1/accounting_link \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx"

Response fields

string

required

Unique accounting link identifier.

string

required

Connected provider ID.

string

required

Connection status. One of active, disconnected, or error.

string

required

Connection mode: test or live.

string

required

ISO 8601 timestamp of when the connection was established.

{
  "id": "alink_01hx9z3k2mfq7nbvd4cw8ej5rt",
  "provider": "xero",
  "status": "active",
  "mode": "live",
  "created_at": "2026-04-29T10:15:00Z"
}

Disconnect

DELETE /v1/accounting_link Disconnects the current accounting provider. Borga will stop syncing invoices and payments immediately. Existing records in your accounting software are not affected.

curl --request DELETE \
  --url https://api.borga.is/v1/accounting_link \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx"

Response fields

Returns an empty body with a 204 No Content status on success.

{}

Get chart of accounts

GET /v1/accounting_link/chart_of_accounts Returns the chart of accounts from your connected accounting provider. Use the GL account codes returned here when configuring default accounts in update settings.

curl --request GET \
  --url https://api.borga.is/v1/accounting_link/chart_of_accounts \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx"

Response fields

object[]

required

Array of GL account objects from your accounting provider.

Show account fields

string

required

GL account code.

string

required

GL account name.

string

required

Account type (e.g. revenue, liability).

{
  "data": [
    {
      "code": "4000",
      "name": "Sales Revenue",
      "type": "revenue"
    },
    {
      "code": "2200",
      "name": "VAT Payable",
      "type": "liability"
    }
  ]
}

Get VAT codes

GET /v1/accounting_link/vat_codes Returns the VAT codes available in your connected accounting provider. Use these when configuring VAT mappings in update settings.

curl --request GET \
  --url https://api.borga.is/v1/accounting_link/vat_codes \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx"

Response fields

object[]

required

Array of VAT code objects.

Show VAT code fields

string

required

VAT code identifier.

string

required

Display name.

number

required

VAT rate as a percentage (e.g. 24 for 24%).

{
  "data": [
    {
      "code": "IS24",
      "name": "Standard Rate 24%",
      "rate": 24
    },
    {
      "code": "IS11",
      "name": "Reduced Rate 11%",
      "rate": 11
    }
  ]
}

Update settings

POST /v1/accounting_link/settings Updates the accounting sync configuration for your connection. Use this to map VAT codes from Borga to your provider, and to set the default GL account for revenue posting.

Request parameters

string

GL account code to use as the default revenue account when posting invoices.

object

A map of Borga VAT rate identifiers to provider VAT code strings. For example, { "standard": "IS24", "reduced": "IS11" }.

curl --request POST \
  --url https://api.borga.is/v1/accounting_link/settings \
  --header "Authorization: Bearer sk_live_..." \
  --header "X-Merchant-Id: mer_xxx" \
  --header "Content-Type: application/json" \
  --data '{
    "default_gl_account": "4000",
    "vat_code_mapping": {
      "standard": "IS24",
      "reduced": "IS11"
    }
  }'

Response fields

string

The configured default GL account code.

object

The configured VAT code mapping.

{
  "default_gl_account": "4000",
  "vat_code_mapping": {
    "standard": "IS24",
    "reduced": "IS11"
  }
}

Overview

Payments

Subscriptions

Billing

Configuration

Accounting Link API — connect accounting providers

List providers

Response fields

Start a connection

Request parameters

Response fields

Complete a connection

Request parameters

Response fields

OAuth callback

Path parameters

Get current link

Response fields

Disconnect

Response fields

Get chart of accounts

Response fields

Get VAT codes

Response fields

Update settings

Request parameters

Response fields

​List providers

​Response fields

​Start a connection

​Request parameters

​Response fields

​Complete a connection

​Request parameters

​Response fields

​OAuth callback

​Path parameters

​Get current link

​Response fields

​Disconnect

​Response fields

​Get chart of accounts

​Response fields

​Get VAT codes

​Response fields

​Update settings

​Request parameters

​Response fields

List providers

Response fields

Start a connection

Request parameters

Response fields

Complete a connection

Request parameters

Response fields

OAuth callback

Path parameters

Get current link

Response fields

Disconnect

Response fields

Get chart of accounts

Response fields

Get VAT codes

Response fields

Update settings

Request parameters

Response fields