Get a list

Gets a single list in your workspace that your access token has access to.

Required scopes: list_configuration:read.

GET /v2/lists/{list}

Get a list

cURL

curl --request GET \
  --url https://api.attio.com/v2/lists/{list} \
  --header 'Authorization: Bearer <token>'

200

{
  "data": {
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "list_id": "33ebdbe9-e529-47c9-b894-0ba25e9c15c0"
    },
    "api_slug": "hiring-engineering",
    "name": "Hiring Engineering",
    "parent_object": [
      "people"
    ],
    "workspace_access": "read-and-write",
    "workspace_member_access": [
      {
        "workspace_member_id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b",
        "level": "read-and-write"
      }
    ],
    "created_by_actor": {
      "type": "workspace-member",
      "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
    },
    "created_at": "2022-11-21T13:22:49.061281000Z"
  }
}

Authorizations

Authorization · string · header · required

This API uses OAuth 2.0 with the authorization code grant flow.

Path Parameters

list · string · required

A UUID or slug to identify the list.

Example:

"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"

Response

200

application/json

Success

Success

data · object · required

Show child attributes