Search accounting code rules

curl --request POST \
  --url https://sandbox.nmbr.co/services/payroll/accounting_code_rules/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "business_entity_id": "<id>",
  "expense_accounting_codes": {
    "include": [
      "<id>"
    ]
  },
  "any_of": [
    {
      "tag_groups": {
        "include": [
          "<id>"
        ]
      },
      "has_tag": true
    },
    {
      "types": {
        "include": [
          "earning"
        ]
      }
    }
  ]
}
'

import requests

url = "https://sandbox.nmbr.co/services/payroll/accounting_code_rules/search"

payload = {
    "business_entity_id": "<id>",
    "expense_accounting_codes": { "include": ["<id>"] },
    "any_of": [{
            "tag_groups": { "include": ["<id>"] },
            "has_tag": True
        }, { "types": { "include": ["earning"] } }]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    business_entity_id: '<id>',
    expense_accounting_codes: {include: ['<id>']},
    any_of: [
      {tag_groups: {include: ['<id>']}, has_tag: true},
      {types: {include: ['earning']}}
    ]
  })
};

fetch('https://sandbox.nmbr.co/services/payroll/accounting_code_rules/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox.nmbr.co/services/payroll/accounting_code_rules/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'business_entity_id' => '<id>',
    'expense_accounting_codes' => [
        'include' => [
                '<id>'
        ]
    ],
    'any_of' => [
        [
                'tag_groups' => [
                                'include' => [
                                                                '<id>'
                                ]
                ],
                'has_tag' => true
        ],
        [
                'types' => [
                                'include' => [
                                                                'earning'
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://sandbox.nmbr.co/services/payroll/accounting_code_rules/search"

	payload := strings.NewReader("{\n  \"business_entity_id\": \"<id>\",\n  \"expense_accounting_codes\": {\n    \"include\": [\n      \"<id>\"\n    ]\n  },\n  \"any_of\": [\n    {\n      \"tag_groups\": {\n        \"include\": [\n          \"<id>\"\n        ]\n      },\n      \"has_tag\": true\n    },\n    {\n      \"types\": {\n        \"include\": [\n          \"earning\"\n        ]\n      }\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://sandbox.nmbr.co/services/payroll/accounting_code_rules/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"business_entity_id\": \"<id>\",\n  \"expense_accounting_codes\": {\n    \"include\": [\n      \"<id>\"\n    ]\n  },\n  \"any_of\": [\n    {\n      \"tag_groups\": {\n        \"include\": [\n          \"<id>\"\n        ]\n      },\n      \"has_tag\": true\n    },\n    {\n      \"types\": {\n        \"include\": [\n          \"earning\"\n        ]\n      }\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sandbox.nmbr.co/services/payroll/accounting_code_rules/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"business_entity_id\": \"<id>\",\n  \"expense_accounting_codes\": {\n    \"include\": [\n      \"<id>\"\n    ]\n  },\n  \"any_of\": [\n    {\n      \"tag_groups\": {\n        \"include\": [\n          \"<id>\"\n        ]\n      },\n      \"has_tag\": true\n    },\n    {\n      \"types\": {\n        \"include\": [\n          \"earning\"\n        ]\n      }\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "id": "<id>",
      "object": "accounting_code_rule",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "tag_group": {
          "id": "<id>",
          "object": "tag_group",
          "links": {
            "self": "/tag_groups/<id>"
          }
        },
        "tag": {
          "id": "<id>",
          "object": "tag",
          "links": {
            "self": "/tags/<id>"
          }
        },
        "type": null,
        "subtype": null,
        "business_preset": null,
        "expense_accounting_code": {
          "id": "<id>",
          "object": "accounting_code",
          "links": {
            "self": "/accounting_codes/<id>"
          }
        },
        "liability_accounting_code": null,
        "expense_accounting_code_template": null,
        "liability_accounting_code_template": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/accounting_code_rules/<id>"
      }
    }
  ],
  "links": {
    "first": "http://localhost/accounting_code_rules/search?page=1",
    "last": "http://localhost/accounting_code_rules/search?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 15,
    "total": 1,
    "has_more": false
  }
}

Accounting Code Rules

Search accounting code rules

Search a business entity’s accounting code rules. The body is a filter set at the root, plus an optional any_of list of filter sets. The root set narrows every result; the any_of sets are combined with OR and then applied together with the root, so a rule matches when it satisfies the root set and at least one any_of entry. An empty body returns every rule for the business entity.

A filter set has the same shape at the root and in each any_of entry:

A field group — tag_groups, tags, types, subtypes, business_presets, expense_accounting_codes, liability_accounting_codes — carries an include and/or exclude list of values. include matches rules whose field is one of the listed values; exclude matches rules whose field is none of them, keeping rules where the field is unset. - A has_<field> boolean — has_tag_group, has_tag, has_type, has_subtype, has_business_preset, has_expense_accounting_code, has_liability_accounting_code — matches rules where the field is set (true) or unset (false).

Field groups and presence booleans within a set combine with AND.

POST

accounting_code_rules

Search accounting code rules

curl --request POST \
  --url https://sandbox.nmbr.co/services/payroll/accounting_code_rules/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "business_entity_id": "<id>",
  "expense_accounting_codes": {
    "include": [
      "<id>"
    ]
  },
  "any_of": [
    {
      "tag_groups": {
        "include": [
          "<id>"
        ]
      },
      "has_tag": true
    },
    {
      "types": {
        "include": [
          "earning"
        ]
      }
    }
  ]
}
'

import requests

url = "https://sandbox.nmbr.co/services/payroll/accounting_code_rules/search"

payload = {
    "business_entity_id": "<id>",
    "expense_accounting_codes": { "include": ["<id>"] },
    "any_of": [{
            "tag_groups": { "include": ["<id>"] },
            "has_tag": True
        }, { "types": { "include": ["earning"] } }]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    business_entity_id: '<id>',
    expense_accounting_codes: {include: ['<id>']},
    any_of: [
      {tag_groups: {include: ['<id>']}, has_tag: true},
      {types: {include: ['earning']}}
    ]
  })
};

fetch('https://sandbox.nmbr.co/services/payroll/accounting_code_rules/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox.nmbr.co/services/payroll/accounting_code_rules/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'business_entity_id' => '<id>',
    'expense_accounting_codes' => [
        'include' => [
                '<id>'
        ]
    ],
    'any_of' => [
        [
                'tag_groups' => [
                                'include' => [
                                                                '<id>'
                                ]
                ],
                'has_tag' => true
        ],
        [
                'types' => [
                                'include' => [
                                                                'earning'
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://sandbox.nmbr.co/services/payroll/accounting_code_rules/search"

	payload := strings.NewReader("{\n  \"business_entity_id\": \"<id>\",\n  \"expense_accounting_codes\": {\n    \"include\": [\n      \"<id>\"\n    ]\n  },\n  \"any_of\": [\n    {\n      \"tag_groups\": {\n        \"include\": [\n          \"<id>\"\n        ]\n      },\n      \"has_tag\": true\n    },\n    {\n      \"types\": {\n        \"include\": [\n          \"earning\"\n        ]\n      }\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://sandbox.nmbr.co/services/payroll/accounting_code_rules/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"business_entity_id\": \"<id>\",\n  \"expense_accounting_codes\": {\n    \"include\": [\n      \"<id>\"\n    ]\n  },\n  \"any_of\": [\n    {\n      \"tag_groups\": {\n        \"include\": [\n          \"<id>\"\n        ]\n      },\n      \"has_tag\": true\n    },\n    {\n      \"types\": {\n        \"include\": [\n          \"earning\"\n        ]\n      }\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sandbox.nmbr.co/services/payroll/accounting_code_rules/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"business_entity_id\": \"<id>\",\n  \"expense_accounting_codes\": {\n    \"include\": [\n      \"<id>\"\n    ]\n  },\n  \"any_of\": [\n    {\n      \"tag_groups\": {\n        \"include\": [\n          \"<id>\"\n        ]\n      },\n      \"has_tag\": true\n    },\n    {\n      \"types\": {\n        \"include\": [\n          \"earning\"\n        ]\n      }\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "id": "<id>",
      "object": "accounting_code_rule",
      "data": {
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "tag_group": {
          "id": "<id>",
          "object": "tag_group",
          "links": {
            "self": "/tag_groups/<id>"
          }
        },
        "tag": {
          "id": "<id>",
          "object": "tag",
          "links": {
            "self": "/tags/<id>"
          }
        },
        "type": null,
        "subtype": null,
        "business_preset": null,
        "expense_accounting_code": {
          "id": "<id>",
          "object": "accounting_code",
          "links": {
            "self": "/accounting_codes/<id>"
          }
        },
        "liability_accounting_code": null,
        "expense_accounting_code_template": null,
        "liability_accounting_code_template": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/accounting_code_rules/<id>"
      }
    }
  ],
  "links": {
    "first": "http://localhost/accounting_code_rules/search?page=1",
    "last": "http://localhost/accounting_code_rules/search?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 15,
    "total": 1,
    "has_more": false
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

business_entity_id

string

required

The business entity whose accounting code rules to search.

any_of

object[]

A list of filter sets combined with OR; a rule matches when it satisfies at least one entry. Each entry has the same shape as the root filter set. An omitted or empty list applies no OR condition.

Hide child attributes

any_of.tag_groups

object

Hide child attributes

any_of.tag_groups.include

string[]

any_of.tag_groups.exclude

string[]

any_of.tags

object

Hide child attributes

any_of.tags.include

string[]

any_of.tags.exclude

string[]

any_of.has_tag

boolean

any_of.types

object

Hide child attributes

any_of.types.include

enum<string>[]

Available options:

allowance,

deduction,

earning,

employee_benefit,

employer_benefit,

employer_statutory_withholding,

reimbursement,

statutory_withholding

any_of.types.exclude

enum<string>[]

Available options:

allowance,

deduction,

earning,

employee_benefit,

employer_benefit,

employer_statutory_withholding,

reimbursement,

statutory_withholding

any_of.has_type

boolean

any_of.subtypes

object

Hide child attributes

any_of.subtypes.include

string[]

any_of.subtypes.exclude

string[]

any_of.has_subtype

boolean

any_of.business_presets

object

Hide child attributes

any_of.business_presets.include

string[]

any_of.business_presets.exclude

string[]

any_of.has_business_preset

boolean

any_of.expense_accounting_codes

object

Hide child attributes

any_of.expense_accounting_codes.include

string[]

any_of.expense_accounting_codes.exclude

string[]

any_of.has_expense_accounting_code

boolean

any_of.liability_accounting_codes

object

Hide child attributes

any_of.liability_accounting_codes.include

string[]

any_of.liability_accounting_codes.exclude

string[]

any_of.has_liability_accounting_code

boolean

tag_groups

object

Hide child attributes

tag_groups.include

string[]

tag_groups.exclude

string[]

Response

200 - application/json

object

string

read-only

The type of the object in Nmbr ("list").

data

object[]

Hide child attributes

data.id

string

read-only

The unique identifier of the object in Nmbr.

data.object

string

read-only

The type of the object in Nmbr ("accounting_code_rule").

data.data

Accounting Code Rule · object

Hide child attributes

data.data.business_entity

object

Hide child attributes

data.data.business_entity.id

string

read-only

The unique identifier of the object in Nmbr.

data.data.business_entity.object

string

read-only

The type of the object in Nmbr ("business_entity").

Hide child attributes

The unique identifier of the object in Nmbr.

The type of the object in Nmbr ("tag_group").

data.data.tag

object

Hide child attributes

data.data.tag.id

string

read-only

The unique identifier of the object in Nmbr.

data.data.tag.object

string

read-only

The type of the object in Nmbr ("tag").

data.data.type

string | null

The line item type this rule applies to (e.g. earning, deduction). When combined with subtype, narrows the rule to a specific line item category. Mutually exclusive with business_preset.

Maximum string length: 255

data.data.subtype

string | null

The line item subtype this rule applies to (e.g. wage, salary). Must be accompanied by a type.

Maximum string length: 255

data.data.business_preset

any

A business preset this rule applies to. Provides the highest specificity match. Mutually exclusive with type and subtype.

data.data.expense_accounting_code

object

The expense accounting code assigned when this rule matches.

Hide child attributes

data.data.expense_accounting_code.id

string

read-only

The unique identifier of the object in Nmbr.

data.data.expense_accounting_code.object

string

read-only

The type of the object in Nmbr ("accounting_code").

data.data.liability_accounting_code

any

The liability accounting code assigned when this rule matches.

data.data.expense_accounting_code_template

object | null

Assembles a formatted accounting code for the journal entry report: each segment resolves to a value, is wrapped and transformed, and the results are concatenated in order. Only valid on rules with no tag and no tag group; null when unset.

Hide child attributes

data.data.expense_accounting_code_template.segments

(Fixed accounting code · object | Tag group code · object)[]

required

Ordered segments concatenated into the generated code.

Required array length: 1 - 20 elements

Emits the referenced accounting code's code.

Fixed accounting code
Tag group code

Hide child attributes

data.data.expense_accounting_code_template.segments.type

enum<string>

required

Available options:

accounting_code

data.data.expense_accounting_code_template.segments.id

string

required

Id of an accounting code in this business entity.

data.data.expense_accounting_code_template.segments.prefix

string | null

Literal text prepended to the resolved value.

Maximum string length: 255

data.data.expense_accounting_code_template.segments.suffix

string | null

Literal text appended to the resolved value.

Maximum string length: 255

data.data.expense_accounting_code_template.segments.transform

enum<string>[] | null

Transforms applied to the resolved value in the order listed.

Available options:

alphanumeric,

lowercase,

uppercase

data.data.expense_accounting_code_template.segments.max_length

integer | null

Truncates the resolved value to this many characters.

Required range: x >= 1

data.data.expense_accounting_code_template.segments.fallback

string | null

Substituted when the resolved value is empty. When absent or empty, an empty segment is dropped instead — prefix and suffix included.

Maximum string length: 255

data.data.liability_accounting_code_template

object | null

Hide child attributes

data.data.liability_accounting_code_template.segments

(Fixed accounting code · object | Tag group code · object)[]

required

Ordered segments concatenated into the generated code.

Required array length: 1 - 20 elements

Emits the referenced accounting code's code.

Fixed accounting code
Tag group code

Hide child attributes

data.data.liability_accounting_code_template.segments.type

enum<string>

required

Available options:

accounting_code

data.data.liability_accounting_code_template.segments.id

string

required

Id of an accounting code in this business entity.

data.data.liability_accounting_code_template.segments.prefix

string | null

Literal text prepended to the resolved value.

Maximum string length: 255

data.data.liability_accounting_code_template.segments.suffix

string | null

Literal text appended to the resolved value.

Maximum string length: 255

data.data.liability_accounting_code_template.segments.transform

enum<string>[] | null

Transforms applied to the resolved value in the order listed.

Available options:

alphanumeric,

lowercase,

uppercase

data.data.liability_accounting_code_template.segments.max_length

integer | null

Truncates the resolved value to this many characters.

Required range: x >= 1

data.data.liability_accounting_code_template.segments.fallback

string | null

Substituted when the resolved value is empty. When absent or empty, an empty segment is dropped instead — prefix and suffix included.

Maximum string length: 255

data.data.created_at

string<dateTime>

read-only

The date and time the object was created in Nmbr.

data.data.updated_at

string<dateTime>

read-only

The date and time the object was last updated in Nmbr.

Delete an accounting code rule List tag groups

⌘I

Overview

Bulk & Batch Operations

Partner

Companies

Employees

Contractors

Payrolls

Line Items

Banking

Reporting

Forms

Vacation Pay

Lookups

Calculations

Miscellaneous

Search accounting code rules

Authorizations

Body

Response