---
title: "List diff scans"
method: GET
path: "/orgs/{org_slug}/diff-scans"
tags: ["diff-scans"]
---

# List diff scans

`GET /orgs/{org_slug}/diff-scans`

Returns a paginated list of all diff scans in an organization.

This endpoint consumes 1 unit of your quota.

This endpoint requires the following org token scopes:
- diff-scans:list

## Path parameters

- `org_slug` string, required

## Query parameters

- `sort` 'created_at' | 'updated_at'
- `direction` 'asc' | 'desc'
- `per_page` integer
- `cursor` string
- `repository_id` string
- `before_full_scan_id` string
- `after_full_scan_id` string

## Response `200`

Lists diff scans for the specified organization.

- object
  - `results` object[], required
    - `id` string, required
    - `organization_id` string, required
    - `repository_id` string, required
    - `created_at` string, required
    - `updated_at` string, required
    - `before_full_scan_id` string, required
    - `after_full_scan_id` string, required
    - `description` string, nullable, required
    - `external_href` string, nullable, required
    - `merge` boolean, required
    - `html_url` string, nullable, required
    - `api_url` string, nullable, required
  - `next_page_href` string, nullable, required
  - `next_cursor` string, nullable, 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)