Skip to main content
GET
/
v1
/
lists
List lists
curl --request GET \
  --url https://api.metal.ai/v1/lists \
  --header 'x-metal-api-key: <api-key>' \
  --header 'x-metal-client-id: <api-key>'
{
  "data": [
    {
      "id": "665f1c2a9b1e4a0012a3b4c5",
      "name": "Q3 sourcing targets",
      "resourceType": "company",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

​
x-metal-client-id
string
header
required

The Client ID of your API key.

​
x-metal-api-key
string
header
required

The secret value of your API key.

Query Parameters

​
page
integer
default:1

Page number, starting at 1 (max 100).

Required range: 1 <= x <= 100
​
limit
integer
default:100

Items per page (1–1000).

Required range: 1 <= x <= 1000

Response

A list of lists.

​
data
object[]