Skip to content

Sellers Report

GET /external/v1/reports/sellers

Returns per-seller commercial KPIs — leads, won deals, revenue, average ticket and conversion rate — ordered by revenue. Built on the same definitions as the rest of the CRM.

Definitions

  • A seller's leads = all opportunities assigned to them (matching the filters).
  • Won = active (lost_at IS NULL and discarded_at IS NULL) and in a is_win_stage stage.
  • conversion_rate = won_count / leads.
  • avg_ticket = won_value / won_count.
  • Opportunities with no owner are excluded.

Authentication

Requires reports:read permission.

Query Parameters

ParameterTypeDefaultDescription
pipeline_idstring-Restrict to a pipeline
sector_idstring-Restrict to a sector/team
fromstring (ISO 8601)-Only opportunities created on/after this date
tostring (ISO 8601)-Only opportunities created on/before this date

Request

bash
curl --request GET \
  --url "https://app.getraze.com/external/v1/reports/sellers?from=2026-01-01" \
  --header "X-API-Key: YOUR_API_KEY"
javascript
const axios = require('axios');

const response = await axios.get('https://app.getraze.com/external/v1/reports/sellers', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
  params: { from: '2026-01-01' }
});

console.log(response.data);
python
import requests

response = requests.get(
    'https://app.getraze.com/external/v1/reports/sellers',
    headers={'X-API-Key': 'YOUR_API_KEY'},
    params={'from': '2026-01-01'}
)

print(response.json())

Response

json
{
  "success": true,
  "data": [
    {
      "owner_user_id": "usr_123",
      "owner_user_name": "Maria Silva",
      "owner_user_email": "maria@acme.com",
      "leads": 58,
      "won_count": 12,
      "won_value": 180000.00,
      "open_count": 30,
      "open_value": 420000.00,
      "lost_count": 16,
      "avg_ticket": 15000.00,
      "conversion_rate": 20.69
    }
  ]
}

Response Fields

FieldTypeDescription
owner_user_id / owner_user_name / owner_user_emailstringThe seller
leadsintegerOpportunities assigned to the seller
won_count / won_valuenumberWon deals and revenue
open_count / open_valuenumberActive, non-won opportunities and their value
lost_countintegerLost/discarded opportunities
avg_ticketnumberwon_value / won_count
conversion_ratenumberwon_count / leads (%)

GetRaze - AI-Powered Lead Generation