Get a referral opportunity

Retrieves a single referral opportunity by deal id. Response is deal-first (pipelineDealId, seeker, provider, connector, facilitators).

Path Parameters
  • id
    Type: stringFormat: uuid
    required

    Referral opportunity (deal) ID

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/api/referral-opps/{id}
curl https://beta-api.introzy.com/api/referral-opps/123e4567-e89b-12d3-a456-426614174000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "success": true,
  "data": {
    "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.046Z",
    "updatedAt": "2026-05-20T14:22:03.046Z"
  }
}