---
title: "Check a technology list"
method: GET
path: "/v1/tech-lookup/lists/{id}"
tags: ["Technology Lists"]
---

# Check a technology list

`GET /v1/tech-lookup/lists/{id}`

## Request

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

Tells you whether the export is `queued`, `ready` or `failed`, and once
ready gives you `download_url` plus the row counts.

Free, so polling is fine. Check every few seconds early on, then back off.

**Read `truncated` before you trust the file as complete.** Plans cap how
many rows an export may contain, and the ceiling is 1,000,000 even on
unlimited plans. When `truncated` is true, `result_count` is how many
websites matched and `exported_rows` is how many the file actually holds;
`withheld_rows` is the difference.

A `failed` list has already had its credit refunded automatically.

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.

## Path parameters

- `id` integer, required

## Response `200`

The list and, once ready, its download link and row counts. Free.

- object
  - `success` boolean, required
  - `report_id` integer, required
  - `status` string, required
  - `technology` string, nullable, required
  - `techapi_id` string, nullable, required
  - `description` string, nullable, required
  - `credits_charged` number, required
  - `credit_type` string, required
  - `result_count` integer, nullable, required
  - `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
  - `download_limit` integer, nullable, required
  - `downloads_remaining` integer, nullable, required
  - `download_url` string, nullable, required

## Other responses

- `401`: Unauthenticated
- `404`
- `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)