---
title: "List your technology lists"
method: GET
path: "/v1/tech-lookup/lists"
tags: ["Technology Lists"]
---

# List your technology lists

`GET /v1/tech-lookup/lists`

## Request

- Base URL: `https://api.stackscan.com/api`
- URL: `https://api.stackscan.com/api/v1/tech-lookup/lists`
- Auth: HTTP bearer and API key in header `X-Tenant-Id`

Every list this workspace has requested, newest first. These are the same
rows the dashboard shows on its Reports page.

Free. Poll this to discover lists that have finished since you last
looked.

Rate limit: 120 requests per minute, counted per API token. Going over returns 429 with `error_code: rate_limited` and a `Retry-After` header in seconds. A 429 costs no credits. Traffic is also subject to a higher shared ceiling per network address, applied before authentication.

## Response `200`

- object
  - `success` boolean, required
  - `page` integer, required
  - `per_page` integer, required
  - `total` integer, required
  - `results` object[], required
    - `report_id` integer, required
    - `status` 'ready' | 'queued' | 'failed', required
    - `technology` string, required
    - `techapi_id` string, nullable, required
    - `description` string, nullable, required
    - `credits_charged` number, required
    - `credit_type` 'standard', required
    - `result_count` integer, nullable, required: These differ when a plan's export cap bites. Read `truncated`.
    - `exported_rows` integer, nullable, required
    - `truncated` boolean, required
    - `withheld_rows` integer, required
    - `created_at` string, nullable, required
    - `failed_at` string, nullable, required
    - `download_count` integer, required: So the 403 ceiling never arrives as a surprise.
    - `download_limit` integer, nullable, required
    - `downloads_remaining` object, nullable, required
    - `download_url` string, nullable, required

## Other responses

- `401`: Unauthenticated
- `429`: Rate limit exceeded. Costs no credits. Back off for the number of seconds in Retry-After.

---

[API](https://skmtc.dev/stackscan/apis/stackscan-api-reference.md) · [All operations](https://skmtc.dev/stackscan/apis/stackscan-api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/stackscan/apis/stackscan-api-reference/revisions/66531cd65f3a?raw)