---
title: "GET /list/{listId}/info"
method: GET
path: "/list/{listId}/info"
tags: ["List"]
---

# GET /list/{listId}/info

`GET /list/{listId}/info`

## Request

- Base URL: `https://api.recordedfuture.com`
- URL: `https://api.recordedfuture.com/list/{listId}/info`
- Auth: one of:
  - API key in header `X-RFToken`
  - OAuth 2
    - Authorization code: `https://id.recordedfuture.com/authorize`
    - Token URL: `https://id.recordedfuture.com/token`

Returns metadata for a specific list including name, type, timestamps, and ownership details.

## Response `200`

Success

- ListInfo
  - `id` string, required
  - `name` string, required
  - `type` 'entity' | 'source' | 'text' | 'custom' | 'ip' | 'domain' | 'tech_stack' | 'industry' | 'brand' | 'partner' | 'industry_peer' | 'location' | 'supplier' | 'vulnerability' | 'company' | 'hash' | 'operation' | 'attacker' | 'target' | 'method' | 'executive', required
  - `created` string, date-time, required
  - `updated` string, date-time, required
  - `owner_id` string: Id of the Owner
  - `owner_name` string: Name of the Owner
  - `organisation_id` string: Id of the Organisation
  - `organisation_name` string: Name of the Organisation
  - `owner_organisation_details` OwnerOrganisationDetails
    - `owner_id` string: Id of the Owner
    - `owner_name` string: Name of the Owner
    - `organisations` Organisation[], required
      - `organisation_id` string: Id of the Organisation
      - `organisation_name` string: Name of the Organisation
    - `enterprise_id` string, required: Id of the Enterprise
    - `enterprise_name` string, required: Name of the Enterprise

## Other responses

- `400`: List is not migrated
- `404`: No such list

---

[API](https://skmtc.dev/recordedfuture/apis/list-api.md) - [All operations](https://skmtc.dev/recordedfuture/apis/list-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recordedfuture/apis/list-api/revisions/95042b3bf39c?raw)