Introduction
How-to guides
Endpoint reference
- OpenAPI
- Core endpoints
- Objects
- Attributes
- Records
- Lists
- Entries
- Workspace members
- Notes
- Tasks
- Threads
- Comments
- Webhooks
- Meta
- Standard objects
- OAuth 2.0
Webhook reference
- Webhook events
Lists
List all lists
List all lists that your access token has access to. lists are returned in the order that they are sorted in the sidebar.
Required scopes: list_configuration:read
.
GET
/
v2
/
lists
Copy
Ask AI
curl --request GET \
--url https://api.attio.com/v2/lists \
--header 'Authorization: Bearer <token>'
Copy
Ask AI
{
"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
This API uses OAuth 2.0 with the authorization code grant flow.
Response
200 - application/json
Success
Was this page helpful?
Copy
Ask AI
curl --request GET \
--url https://api.attio.com/v2/lists \
--header 'Authorization: Bearer <token>'
Copy
Ask AI
{
"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"
}
]
}
Assistant
Responses are generated using AI and may contain mistakes.