---
title: "Trend of historical dependencies (Beta)"
method: GET
path: "/orgs/{org_slug}/historical/dependencies/trend"
tags: ["dependencies"]
---

# Trend of historical dependencies (Beta)

`GET /orgs/{org_slug}/historical/dependencies/trend`

Trend analytics of historical dependencies.

This endpoint consumes 10 units of your quota.

This endpoint requires the following org token scopes:
- historical:dependencies-trend

## Path parameters

- `org_slug` string, required

## Query parameters

- `date` string
- `range` string
- `repoFullName` string
- `repoSlug` string
- `repoLabels` string
- `artifactType` string
- `dependencyDirect` boolean
- `dependencyDev` boolean
- `dependencyDead` boolean

## Response `200`

The trend data

- object
  - `meta` object, required
    - `organizationId` string, required
    - `startDateInclusive` string, required
    - `endDateInclusive` string, required
    - `interval` string, required
    - `aggregation` object, required
      - `fields` string[], required
      - `groups` array[], required
        - string[]
    - `filters` object, required
      - `repoFullName` string[] — Comma-separated list of repo full names that should be included
      - `repoSlug` string[] — Comma-separated list of repo slugs that should be included
      - `repoLabels` string[] — Comma-separated list of repo labels that should be included
      - `artifactType` string[] — Comma-separated list of artifact types (e.g. "npm", "pypi", "gem", "maven", "golang", etc.) that should be included
      - `dependencyDirect` boolean[] — Direct/transitive dependency filter flag
      - `dependencyDev` boolean[] — Development/production dependency filter flag
      - `dependencyDead` boolean[] — Dead/reachable dependency filter flag
  - `items` object[], required
    - `date` string, required
    - `startOfDayTimestamp` number, required
    - `dataPoints` object[], required
      - `aggregationGroup` string[], required
      - `count` integer, required
      - `countDelta` integer, required
      - `countDirect` integer, required
      - `countDirectDelta` integer, required
      - `countIndirect` integer, required
      - `countIndirectDelta` integer, required
      - `countsBySeverity` object, required
        - `low` object, required
          - `count` integer, required
          - `countDelta` integer, required
          - `countDirect` integer, required
          - `countDirectDelta` integer, required
          - `countIndirect` integer, required
          - `countIndirectDelta` integer, required
        - `medium` object, required
          - `count` integer, required
          - `countDelta` integer, required
          - `countDirect` integer, required
          - `countDirectDelta` integer, required
          - `countIndirect` integer, required
          - `countIndirectDelta` integer, required
        - `high` object, required
          - `count` integer, required
          - `countDelta` integer, required
          - `countDirect` integer, required
          - `countDirectDelta` integer, required
          - `countIndirect` integer, required
          - `countIndirectDelta` integer, required
        - `critical` object, required
          - `count` integer, required
          - `countDelta` integer, required
          - `countDirect` integer, required
          - `countDirectDelta` integer, required
          - `countIndirect` integer, required
          - `countIndirectDelta` integer, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Insufficient max_quota for API method
- `404` — Resource not found
- `429` — Insufficient quota for API route

---

[API](https://skmtc.dev/socket-dev/apis/socket.md) · [All operations](https://skmtc.dev/socket-dev/apis/socket/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/socket-dev/socket/revisions/bf994b75d33f/schema)