---
title: "Spend credits and finalize a ready lead list"
method: POST
path: "/lists/{id}"
tags: ["Lists"]
---

# Spend credits and finalize a ready lead list

`POST /lists/{id}`

## Request

- Base URL: `https://api.wappalyzer.com/v2`
- URL: `https://api.wappalyzer.com/v2/lists/{id}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/wappalyzer/apis/wappalyzer-public-api/docs/lists/:id/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required

## Request body

- FinalizeListRequest
  - `spendCredits` integer, required

## Response `200`

Lead list finalized successfully.

- FinalizeListResponse
  - `id` string, required
  - `status` 'Complete', required
  - `url` string, uri

## Other responses

- `400`: The request payload or query string was invalid.
- `403`: Authorization failed, the resource or method is invalid, or the account lacks sufficient credits.
- `429`: Rate limit exceeded.

---

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