Lists

Get a list

Scope: sourcing:read.

get/v1/lists/{list_id}

Request

Base URL: https://api.recruitmcp.com
URL: https://api.recruitmcp.com/v1/lists/{list_id}
Auth: one of:
- HTTP bearer
- OAuth 2 (authorization code, authorization URL https://recruitmcp.com/oauth/authorize, token URL https://recruitmcp.com/oauth/token, scopes: sourcing:read)

list_idstring required

RecruitMCP-Version'2026-10-13'

API version. Defaults to the version the key was created with. Supported: 2026-10-13.

RecruitMCP-Customerstring

Act inside this customer (cus_…). Ignored for keys bound to a customer, which always act inside theirs.

The list.

idstring required

object'list' required

namestring required

descriptionstring nullable

item_countinteger required

People still on the list. Suppressed people are not counted, matching the items view and the CSV.

created_atstring date-time

updated_atstring date-time