Departments

The Department Object

A Rutter Department represents a categorization for bills and expenses that logs the employer-level origin of the purchase.

Properties

idstringRequired

The Rutter generated unique ID of the department.

platform_idstringRequired

The platform specific ID of the department.

parent_idstringnullableRequired

The Rutter ID of the Parent Department linked to the department.

has_childrenbooleannullableRequired

Describes whether the department has child departments.

namestringnullableRequired

The name of the department.

statusenum

The status of the department.

One ofactive or archived.
created_atstringnullableRequired

The ISO 8601 timestamp that the department was created.

updated_atstringnullableRequired

The ISO 8601 timestamp that the department was last updated.

last_synced_atstringRequired

The ISO 8601 timestamp when the department was last synced by Rutter.

platform_dataobject

The raw platform data corresponding to the Rutter object.

Endpoints
GET
/accounting/departments

List Departments

GEThttps://production.rutterapi.com/versioned/accounting/departments

Request Parameters

    access_tokenstringqueryRequired

    The access token of the connection.

    cursorstringquery

    The cursor to use for pagination. This value is passed in from next_cursor field in a previous request.

    expandenumquery

    Used to request inclusion of optional objects.

    Can beplatform_data.
    force_fetchenumquery

    Force a response even if the underlying connection hasn't finished the initial sync.

    One oftrue or false.
    last_synced_at_minintegerquery

    Unix Timestamp in milliseconds representing the minimum last_synced_at datetime to fetch entities from.

    limitintegerquery

    The limit on the number of entities returned.

    sortstringquery

    The field and direction to sort by (ASC or DESC), e.g. last_synced_at ASC. Currently supports the fields: updated_at, last_synced_at. If a field is provided but ASC or DESC is not, defaults to ASC. If this field is omitted, defaults, to updated_at DESC.

    updated_at_maxintegerquery

    Unix Timestamp in milliseconds representing the maximum updated_at datetime to fetch entities from.

    updated_at_minintegerquery

    Unix Timestamp in milliseconds representing the minimum updated_at datetime to fetch entities from.

Response Body

    departmentsarrayRequired
    Show departments attributes
    next_cursorstringnullable
Support by integration
  • Netsuite
    Netsuite
  • Quickbooks
    Quickbooks
  • Sage Intacct
    Sage Intacct
Example Response Body
JSON
1
{
2
"departments": [
3
{
4
"id": "00000000-0000-0000-0000-000000000000",
5
"platform_id": "12345678",
6
"parent_id": "00000000-0000-0000-0000-000000000000",
7
"has_children": false,
8
"name": "Engineering",
9
"status": "active",
10
"created_at": "2023-01-02T02:34:56.000Z",
11
"updated_at": "2023-01-02T02:34:56.000Z",
12
"last_synced_at": "2023-01-02T02:34:56.000Z",
13
"platform_data": {
14
"id": 123,
15
"data": "Varies by platform"
16
}
17
}
18
],
19
"next_cursor": "MTY3NDgzMTk0Ml82MDY4ZDI0ZC02NGRmLTRmN2EtYTM0Ny0zN2ZmNjY5MGVmMjU="
20
}

Have questions?

Contact support for personalized guidance.

Contact support