---
title: "Get one list's metadata"
method: GET
path: "/business/lists/{listId}"
tags: ["Lists"]
---

# Get one list's metadata

`GET /business/lists/{listId}`

## Request

- Base URL: `https://api.tryfuse.ai/api/v1`
- URL: `https://api.tryfuse.ai/api/v1/business/lists/{listId}`
- Auth: HTTP basic

One list's metadata: name, kind (`entityType`), `completionStatus` (`processing` while an import, copy, save-to-list or enrichment is still populating it, `complete` otherwise — poll this after any 202 that targets the list), the row count, and the enrichment `metrics` (rows enriched and rows carrying a LinkedIn URL, professional email, personal email or valid phone). `metrics` is null for a company list, where those counters do not apply. `?include=columns` adds the custom and smart column definitions.

Errors:
- `404` `LIST_NOT_FOUND` — No list with that id is visible to the token owner.
- `422` `VALIDATION_FAILED` — listId is not a 24-hex id, or include is not "columns".
- `429` `RATE_LIMITED` — The lists rate bucket is exhausted.

Requires one of the following token scopes: lists.

## Path parameters

- `listId` string, required: 24-character hex id of the list (from GET /business/lists).

## Query parameters

- `include` 'columns': Set to columns to add the list's custom column definitions (id, name, type) to the response.

## Response `200`

Success

- object
  - `list` object, required
    - `id` string, required
    - `name` string, nullable, required
    - `entityType` 'contactList' | 'companyList', required
    - `completionStatus` string, nullable, required
    - `totalRecords` integer, required
    - `metrics` object, nullable, required
      - `totalEnriched` integer, required
      - `totalWithLinkedin` integer, required
      - `totalWithProfessionalEmail` integer, required
      - `totalWithPersonalEmail` integer, required
      - `totalWithValidPhone` integer, required
    - `columns` object[]
      - `id` string, required
      - `name` string, required
      - `type` string, required

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `422`: Error
- `429`: Error
- `500`: Error

---

[API](https://skmtc.dev/fuseai/apis/fuse-business-api.md) · [All operations](https://skmtc.dev/fuseai/apis/fuse-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fuseai/apis/fuse-business-api/revisions/50d95e0536f4?raw)