# List co-sell referrals (inbound + outbound)

`GET https://api.suger.cloud/org/{orgId}/cosell/referral`

List co-sell referrals under the organization with pagination, filters, and sort.

Covers both inbound (received from a partner) and outbound (shared by us). Use the `q` filter expression to scope by `partner` (AWS / AZURE / GCP), `status`, `stage`, time range, etc.

Legal Suger unified status values (DB enum, UPPER_SNAKE_CASE): DRAFT, PENDING_CREATE, CREATE_FAILED, UPDATE_FAILED, IN_REVIEW, PENDING_ACCEPTANCE, ACTION_REQUIRED, ACTIVE, EXPIRED, CLOSED_WON, CLOSED_LOST, CLOSED_ERROR, REJECTED. (DELETED rows are filtered out server-side.)

Filter example (qs=lisp, the default): `q=(and (eq partner "AWS") (eq status "IN_REVIEW"))`.

Use this when: user wants to browse, search, or filter existing co-sell referrals.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgId` | path | string | yes | Organization ID |
| `page_size` | query | integer | no | Number of items per page (default 20, max 100) |
| `page_number` | query | integer | no | Page number (default 1) |
| `qs` | query | string | no | Query style: 'json' or 'lisp' (default 'lisp') |
| `q` | query | string | no | Filter expression in the format specified by qs param |
| `ss` | query | string | no | Sort style: 'json' or 'simple' (default 'simple') |
| `s` | query | string | no | Sort expression in the format specified by ss param |

## Responses

### 200 — OK

Content-Type: `application/json` · Schema: `ListCosellReferralsResponse`

### 400 — Bad request error

Content-Type: `application/json`

### 500 — Internal server error

Content-Type: `application/json`

---

Interactive API reference: https://doc.suger.io/api/