---
title: "Gets a list of Opportunity State Reasons"
method: GET
path: "/OpportunityStateReasons"
tags: ["OpportunityStateReasons"]
---

# Gets a list of Opportunity State Reasons

`GET /OpportunityStateReasons`

## Request

- Base URL: `https://api.insightly.com/v3.1`
- URL: `https://api.insightly.com/v3.1/OpportunityStateReasons`
- Auth: none declared. Required headers: `Authorization`

This endpoint returns a list of opportunity state reasons set up for the Insightly instance.            This is a read only endpoint, so to add or update opportunity state reasons, you will need to do that via the web app.            Opportunity state reasons are used to indicate why the opportunity state was set to its current value.            For example, you can use this to indicate why you lost a particular sale.

## Query parameters

- `skip` integer
- `top` integer
- `count_total` boolean

## Headers

- `Authorization` string, required

## Response `200`

Request succeeded.

- object[]
  - `STATE_REASON_ID` integer
  - `STATE_REASON` string
  - `FOR_OPPORTUNITY_STATE` string

## Other responses

- `400`: Often missing or invalid parameter.
- `401`: Authentication failed.

---

[API](https://skmtc.dev/insightly/apis/insightly-api-v3-1.md) - [All operations](https://skmtc.dev/insightly/apis/insightly-api-v3-1/llms.txt) - [OpenAPI document](https://skmtc.dev/insightly/apis/insightly-api-v3-1/revisions/e7df0c3b65fb?raw)