---
title: "Get Dashboard Invoice Setup"
method: GET
path: "/dashboardsettings/invoicesetup/{setupId}"
tags: ["DashboardSettings"]
---

# Get Dashboard Invoice Setup

`GET /dashboardsettings/invoicesetup/{setupId}`

## Request

- Base URL: `https://sb2api.servicechannel.com/v3`
- URL: `https://sb2api.servicechannel.com/v3/dashboardsettings/invoicesetup/{setupId}`
- Auth: OAuth 2
  - Authorization code: `https://sb2login.servicechannel.com/oauth/authorize`
  - Token URL: `https://sb2login.servicechannel.com/oauth/token`
- TypeScript: <https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/docs/dashboardsettings/invoicesetup/:setupId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a Dashboard Invoice Setup

## Path parameters

- `setupId` integer, required

## Response `200`

Indicates that the request succeeded

- ServiceChannelServicesMessagingDashboardSettingsSetupInvoiceResponse: Represents the response for the Dashboard Invoice settings.
  - `EnableInvoices` boolean: Gets or sets a value indicating whether invoice processing is enabled.
  - `ViewOnly` boolean: Gets or sets a value indicating whether invoice actions are disabled on this dashboard.
  - `ChangeableCategory` boolean: Gets or sets a value indicating whether category is changeable on the Invoice Approval Page.
  - `ChangeableGlCode` boolean: Gets or sets a value indicating whether Approve Code (GL) is changeable on the Invoice Approval Page.
  - `ChangeableNextRecipient` boolean: Gets or sets a value indicating whether Next Recipient is changeable on the Invoice Approval Page.

## Other responses

- `401`: Indicates that the requested resource requires authentication. <br>Error codes: 504 - API call rejected by security permissions;
- `403`: Access denied. <br>Error codes: 1000 - The setupId does not belong to the Subscriber;
- `404`: Indicates that the requested resource does not exist on the server.
- `500`: The server was unable to complete the request due to an internal error. <br/>Error codes: 501 - Unspecified internal server error occurred

---

[API](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3.md) - [All operations](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/llms.txt) - [OpenAPI document](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/revisions/d490d6596809?raw)