---
title: "Get reason codes for refrigerant use"
method: GET
path: "/refrigeranttracking/{subscriberId}/GetRefrigerantUseReasonCodes"
tags: ["RefrigerantTracking"]
---

# Get reason codes for refrigerant use

`GET /refrigeranttracking/{subscriberId}/GetRefrigerantUseReasonCodes`

## Request

- Base URL: `https://sb2api.servicechannel.com/v3`
- URL: `https://sb2api.servicechannel.com/v3/refrigeranttracking/{subscriberId}/GetRefrigerantUseReasonCodes`
- 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/refrigeranttracking/:subscriberId/GetRefrigerantUseReasonCodes/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of reason codes for the refrigerant part use. For example, leak or repair.

## Path parameters

- `subscriberId` integer, required

## Response `200`

The list of reason codes is in the response.

- ServiceChannelServicesMessagingRefrigerantTrackingRefrigerantUseReasonCode[]
  - `Id` integer: Unique numeric identifier of the refrigerant use reason code.
  - `Order` integer: Order of appearance of a reason code.
  - `Purpose` integer: Unique numeric identifier of the reason code for the refrigerant part use. Possible values: `0` - Leak, `1` - InitialCharge, `2` - SystemExpansion, `3` - Removal, `4` - Other, `5` - RemovedReused, `6` - Retrofit. <br />Each reason code on the subscriber side is associated with a hardcoded purpose value in the database. Since reason codes can vary across subscribers, the purpose helps identify the valid reason code. <br />***Note:*** Purpose value `0` is assigned to the `Leak` and `Repair` reason codes, indicating that a leak record gets calculated for these reason codes.
  - `Name` string: Reason code name for the refrigerant part use as configured by the subscriber. Possible values: • `Leak` • `Repair` • `Adjustment` • `System Expansion` • `Removal` • `Initial Charge` • `Retrofit` • `Removed Reused`
  - `SubscriberId` integer: Unique numeric identifier of the subscriber.
  - `IsActive` boolean: Defines whether a user can select a reason code when capturing refrigerant use. Possible response values: • `true`: Reason code is enabled. • `false`: Reason code is disabled.

## Other responses

- `400`: The request was not accepted due to bad syntax, missing parameters, insufficient data, etc. <br/>Error codes: 502 &mdash; No leak tracking preferences
- `401`: The requested resource requires authentication. <br/>Error codes: 504 &mdash; API call rejected by security permissions
- `404`: The requested resource does not exist on the server.

---

[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)