List referral opportunities

Retrieves a paginated list of referral opportunities in the REFERRAL pipeline. Each item is deal-first: pipelineDealId matches id, with seeker, provider, connector, and facilitators on the deal (no nested connection object).

Query Parameters

limit
Type: integer
min:
1
max:
100

Integer numbers.
offset
Type: integer
min:
0

Integer numbers.

Responses

application/json
application/json
application/json

get/api/referral-opps

curl 'https://beta-api.introzy.com/api/referral-opps?limit=50&offset=0' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "success": true,
  "data": {
    "referralOpps": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "pipelineDealId": "123e4567-e89b-12d3-a456-426614174000",
        "name": "Alice Seeker → Bob Provider",
        "description": null,
        "expectedValue": null,
        "currency": "USD",
        "stage": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "label": "Lead",
          "color": "#3B82F6",
          "description": "string",
          "sortOrder": 1
        },
        "owner": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "firstName": "string",
          "lastName": "string",
          "email": "string"
        },
        "seeker": {
          "type": "USER",
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "firstName": null,
          "lastName": null,
          "email": null,
          "name": null,
          "company": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "string"
          }
        },
        "provider": {
          "type": "USER",
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "firstName": null,
          "lastName": null,
          "email": null,
          "name": null,
          "company": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "string"
          }
        },
        "connector": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "firstName": null,
          "lastName": null,
          "email": null,
          "company": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "string"
          }
        },
        "facilitators": [
          {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "userId": null,
            "companyId": null,
            "role": "connector",
            "side": "seeker",
            "user": {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "firstName": "string",
              "lastName": "string",
              "email": "string"
            },
            "company": {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "name": "string"
            }
          }
        ],
        "createdAt": "2026-05-20T14:22:03.090Z",
        "updatedAt": "2026-05-20T14:22:03.090Z"
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "hasMore": true
  }
}

List of referral opportunities