---
updatedAt: 2026-04-21T04:46:34.000Z
agentTools:
  projectIndex: https://developer.alloy.com/public/llms.txt
---

# Get all Lists

Returns the set of all Lists for your account

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Alloy API",
    "version": "1.0.0",
    "description": "hey hey hey, it's the Alloy API!"
  },
  "servers": [
    {
      "url": "https://sandbox.alloy.co/v1",
      "description": "Sandbox endpoint"
    }
  ],
  "security": [
    {
      "oauth2": []
    },
    {
      "basic": []
    }
  ],
  "tags": [
    {
      "name": "Lists",
      "description": "Manage lists of applicant PII. These lists allow for allow-listing and deny-listing applicants based on their personal information."
    }
  ],
  "paths": {
    "/lists": {
      "get": {
        "tags": [
          "Lists"
        ],
        "summary": "Get all Lists",
        "description": "Returns the set of all Lists for your account",
        "responses": {
          "200": {
            "description": "All Lists for account",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status_code": {
                      "type": "number"
                    },
                    "error": {
                      "type": "object"
                    },
                    "timestamp": {
                      "type": "integer"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "list_token": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "is_blacklist": {
                            "type": "boolean"
                          },
                          "is_whitelist": {
                            "type": "boolean"
                          },
                          "description": {
                            "type": "string"
                          },
                          "created_at": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "entities_count": {
                            "type": "number"
                          }
                        }
                      }
                    }
                  },
                  "example": {
                    "status_code": 200,
                    "error": null,
                    "timestamp": 1557675468774,
                    "data": [
                      {
                        "list_token": "I-o2RgMSb72V1p8834bokr",
                        "name": "Allowlist",
                        "is_blacklist": false,
                        "is_whitelist": true,
                        "description": null,
                        "created_at": "2024-02-23T16:52:36.957Z",
                        "entities_count": 0
                      },
                      {
                        "list_token": "I-CRAAplpejPkJnLpWCpxy",
                        "name": "Denylist",
                        "is_blacklist": true,
                        "is_whitelist": false,
                        "description": null,
                        "created_at": "2024-02-23T16:52:36.957Z",
                        "entities_count": 0
                      }
                    ]
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "basic": {
        "type": "http",
        "description": "HTTP basic authorization using a workflow token and secret",
        "scheme": "basic"
      },
      "oauth2": {
        "type": "oauth2",
        "description": "Oauth2 using a workflow token and secret to generate a bearer token",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "/oauth/bearer",
            "scopes": {}
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": false
  }
}
```