# Get List member data (/docs/api-reference/get_list_member_data)

`GET /v1/lists/{list_id}/member-data` · operation `get_list_member_data`

Read SMB data columns for up to 100 given members of a List, such as the rows on screen after adding a column. Same cells and rules as get_list_members fields; a Business that is not a current member is left out. Free; with paid columns, usage gives the Workspace's credits_remaining.

**Sign-in:** a signed-in person's access token (`Authorization: Bearer …`), which AI apps get through MCP sign-in; or a Workspace API key in the `X-SMB-API-Key` header.

### Path parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `list_id` | string | yes |  |

### Query parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `fields` | string | no | SMB data columns to add to each member, comma separated: column keys from list_fields, such as team, revenue, value or payroll. Free to ask for; paid columns show values on the List's first 5 members and on Businesses this Workspace unlocked. |
| `ids` | string | no |  |

### Headers

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `SMB-Workspace-Id` | string (uuid) | yes |  |

### Response

**200** Successful authorized response.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | object | yes |  |
| `data.list_id` | string | yes |  |
| `data.list_version` | integer | yes |  |
| `data.evaluated_at` | string (date-time) | yes |  |
| `data.members` | array of object | yes |  |
| `request_id` | string | yes |  |
| `usage` | object | no | Credits this call used, from the same transaction as any charge. 1,000,000 credits = $1.00. Paid fields cost credits only when a value comes back that this Workspace hasn't unlocked; an unlock lasts 12 months. |
| `usage.credits_charged` | integer | yes | Credits this call charged; 0 when it charged nothing. |
| `usage.credits_remaining` | integer | no | The Workspace's spendable credits after this call. Left out when this call didn't read the balance. |
| `usage.unit` | `usd_micro` | yes | usd_micro: one millionth of a US dollar. |
| `usage.unlocked_until` | string (date-time) | no | When what this call paid for locks again (12 months). Only when it charged. |

### Errors

- `400` The request is invalid.
- `401` Authentication is required.
- `403` The caller is not authorized.
- `404` The resource was not found.
- `409` The resource revision or idempotency input conflicts.
- `413` The request body is too large.
- `415` The request must be JSON.
- `422` Required evidence is missing.
- `429` Rate limit reached; honor Retry-After.
- `500` The request could not be completed.
- `502` A dependency returned an invalid response.
- `503` The service is temporarily unavailable.

### Example

```bash
curl --request GET "https://api.smb.co/v1/lists/$LIST_ID/member-data" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header "SMB-Workspace-Id: $WORKSPACE_ID"
```