List is a JSON Structure definition published by HubSpot, describing 9 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/crm-lists-api-list-structure.json",
"name": "List",
"description": "A HubSpot CRM list.",
"type": "object",
"properties": {
"listId": {
"type": "string",
"description": "The unique identifier for the list.",
"example": "500123"
},
"name": {
"type": "string",
"description": "The name of the list.",
"example": "Example Record"
},
"listType": {
"type": "string",
"enum": [
"STATIC",
"DYNAMIC"
],
"description": "Whether the list is static (manually managed) or dynamic (filter-based).",
"example": "STATIC"
},
"objectTypeId": {
"type": "string",
"description": "The object type the list contains (e.g., 0-1 for contacts).",
"example": "500123"
},
"processingStatus": {
"type": "string",
"description": "The current processing status of the list.",
"example": "active"
},
"createdAt": {
"type": "datetime",
"description": "The date and time the list was created.",
"example": "2025-03-15T14:30:00Z"
},
"updatedAt": {
"type": "datetime",
"description": "The date and time the list was last updated.",
"example": "2025-03-15T14:30:00Z"
},
"filterBranch": {
"type": "object",
"description": "The filter definition for dynamic lists.",
"example": {}
},
"memberCount": {
"type": "int32",
"description": "The current number of members in the list.",
"example": 10
}
}
}
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.