---
title: "List GitLab integration runs."
method: GET
path: "/integrations/gitlab/{id}/runs"
tags: ["Integrations"]
---

# List GitLab integration runs.

`GET /integrations/gitlab/{id}/runs`

## Request

- Base URL: `https://public.escape.tech/v3`
- URL: `https://public.escape.tech/v3/integrations/gitlab/{id}/runs`
- Auth: API key in header `X-ESCAPE-API-KEY`

List the discovery runs executed by a GitLab integration, most recent first.

## Path parameters

- `id` string, required: The integration ID

## Query parameters

- `cursor` string: The cursor to start the pagination from. Returned by the previous page response. If not provided, the first page will be returned.
- `size` integer: The number of items to return per page
- `sortType` 'CREATED_AT': The type to sort by
- `sortDirection` 'asc' | 'desc': The direction to sort by

## Response `200`

OK

- object
  - `nextCursor` string, nullable, required
  - `totalCount` integer
  - `data` object[], required
    - `id` string, uuid, required: The id of the run
    - `kind` 'ACT_USING_UPDATE_ASSET' | 'ASM_APK' | 'ASM_AWS_LAMBDA' | 'ASM_BITBUCKET_REPOSITORY' | 'ASM_BURPSUITE_EXPORT' | 'ASM_CODE_PROJECT' | 'ASM_DNS' | 'ASM_GITHUB_REPOSITORY' | 'ASM_GITLAB_REPOSITORY' | 'ASM_GRAPHQL' | 'ASM_GRAPHQL_SCHEMA' | 'ASM_GRPC' | 'ASM_HAR_EXPORT' | 'ASM_INSOMNIA' | 'ASM_IPV4' | 'ASM_IPV4_RANGE' | 'ASM_IPV6' | 'ASM_MCP' | 'ASM_OPENAPI' | 'ASM_PACKAGE' | 'ASM_POSTMAN_COLLECTION' | 'ASM_POSTMAN_ENVIRONMENT' | 'ASM_REST' | 'ASM_SOAP' | 'ASM_SOFTWARE' | 'ASM_WEBAPP' | 'ASM_WEBSOCKET' | 'ASM_WP_JSON' | 'AUTOMATED_PENTEST' | 'BLST_GRAPHQL' | 'BLST_REST' | 'BUILD_SCHEMA' | 'CONTINUOUS_PENTEST' | 'EXPORT_USING_AZURE_BOARDS' | 'EXPORT_USING_JIRA' | 'EXPORT_USING_SERVICENOW' | 'EXPORT_USING_WEBHOOK' | 'EXPORT_USING_WIZ' | 'EXTERNAL_NETWORK_PENTEST' | 'FRONTEND_DAST' | 'MOBILE_APP_PENTEST' | 'NOTIFY_USING_DISCORD' | 'NOTIFY_USING_EMAILS' | 'NOTIFY_USING_SLACK' | 'NOTIFY_USING_TEAMS' | 'PARSE_PENTEST_SCENARIO_TEMPLATES' | 'PULL_AKAMAI' | 'PULL_AWS' | 'PULL_AWS_ACCOUNT' | 'PULL_AZURE' | 'PULL_AZURE_BOARDS' | 'PULL_AZURE_KEY_VAULT' | 'PULL_BITBUCKET' | 'PULL_CLOUDFLARE' | 'PULL_CUSTOM' | 'PULL_GCP' | 'PULL_GITHUB' | 'PULL_GITLAB' | 'PULL_JIRA' | 'PULL_K8S' | 'PULL_POSTMAN' | 'PULL_WIZ' | 'REGRESSION_TESTING' | 'RETEST' | 'SCAN_ISSUE_REPLAY' | 'VALIDATE_AKAMAI' | 'VALIDATE_AWS' | 'VALIDATE_AWS_ACCOUNT' | 'VALIDATE_AZURE_BOARDS' | 'VALIDATE_AZURE_KEY_VAULT' | 'VALIDATE_BITBUCKET' | 'VALIDATE_CLOUDFLARE' | 'VALIDATE_CONFIG' | 'VALIDATE_DNS' | 'VALIDATE_GCP' | 'VALIDATE_GITHUB' | 'VALIDATE_GITLAB' | 'VALIDATE_GRAPHQL' | 'VALIDATE_IPV4' | 'VALIDATE_IPV4_RANGE' | 'VALIDATE_IPV6' | 'VALIDATE_JIRA' | 'VALIDATE_K8S' | 'VALIDATE_PENTEST' | 'VALIDATE_PENTEST_APK' | 'VALIDATE_PENTEST_NETWORK' | 'VALIDATE_POSTMAN' | 'VALIDATE_REST' | 'VALIDATE_SERVICENOW' | 'VALIDATE_WEBAPP' | 'VALIDATE_WIZ', required: The kind of discovery workflow that ran
    - `status` 'CANCELED' | 'FAILED' | 'FINISHED' | 'RUNNING' | 'STARTING', required: The status of the run
    - `createdAt` string, date-time, required: The date and time the run was created
    - `finishedAt` string, date-time, nullable, required: The date and time the run finished
    - `duration` number, required: The duration of the run in milliseconds
    - `progressRatio` number, required: The progress ratio of the run, between 0 and 1

## Other responses

- `400`: Pagination error
- `404`: Not found

---

[API](https://skmtc.dev/escape/apis/escape-public-api.md) - [All operations](https://skmtc.dev/escape/apis/escape-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/escape/apis/escape-public-api/revisions/2eab35df40c7?raw)