> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Quality

### QA score trend series

<Note>
  `GET /api/v1/quality/trends`
</Note>

Time series of official reviewer-authored QA evaluation scores — per-day averages plus per-agent and per-scorecard-form breakdowns. Answers "is quality trending up?" against the scorecard rubrics an org actually grades with; pairs with the point-in-time rollup at `GET /quality/summary`. Self-evaluations (an agent scoring their own call) and appealed/resolved rows are excluded so only current official scores drive the trend. Read-only; requires an owner, admin, or supervisor role.

<ParamField query="days" type="string">
  Look-back window in days over each evaluation's creation time (1-90). Defaults to 30, capped at 90; an out-of-range or non-numeric value falls back to 30.
</ParamField>

<ParamField query="form_id" type="string">
  Restrict the trend to a single scorecard form (rubric) id from /quality/evaluation-forms. Defaults to every form; an over-long value falls back to all forms.
</ParamField>

<ParamField query="agent_id" type="string">
  Drill the whole trend into one evaluated agent's scores. Defaults to every agent; an over-long value falls back to all agents.
</ParamField>

<RequestExample>
  <CodeGroup>
    ```bash cURL theme={null}
    curl -X GET "https://api.orbit.devotel.io/api/v1/quality/trends?days=30" \
      -H "X-API-Key: dv_live_sk_your_key_here"
    ```

    ```typescript Node.js theme={null}
    import { Orbit } from '@devotel-orbit/node'

    const orbit = new Orbit({
      apiKey: process.env.ORBIT_API_KEY!,
    })

    const res = await fetch('https://api.orbit.devotel.io/api/v1/quality/trends?days=30', {
      method: 'GET',
      headers: {
        'X-API-Key': process.env.ORBIT_API_KEY!,
      },
    })
    console.log(await res.json())
    ```

    ```python Python theme={null}
    import os, requests

    headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
    r = requests.get("https://api.orbit.devotel.io/api/v1/quality/trends?days=30", headers=headers)
    print(r.json())
    ```
  </CodeGroup>
</RequestExample>