Skip to main content
GET
/
api
/
v1
/
operations
/
autocomplete
/
person-metadata
Autocomplete Person Metadata
curl --request GET \
  --url https://api.example.com/api/v1/operations/autocomplete/person-metadata \
  --header 'Authorization: Bearer <token>'
[
  {
    "key": "Software Engineer",
    "value": 1542
  },
  {
    "key": "Product Manager",
    "value": 987
  },
  {
    "key": "Data Scientist",
    "value": 654
  },
  {
    "key": "Engineering Manager",
    "value": 432
  },
  {
    "key": "VP of Engineering",
    "value": 156
  }
]
Provides metadata statistics. This endpoint returns aggregated counts of persons grouped by various attributes such as job titles, seniority levels, and other person-related classifications. Useful for understanding the composition of your lead database and building analytics dashboards.

​
Authentication

This endpoint requires authentication. The user must be signed in to access metadata.
This endpoint proxies requests to the persons search metadata API. Results are cached for 7 days to improve performance.

​
Request

​
size
integer
default:"25"
Number of metadata items to return per page.
​
page
integer
default:"0"
Zero-based page number for pagination.

​
Response

Returns an array of metadata items, each containing a key-value pair representing an attribute and its count.
​
response
PersonMetadataItem[]
Array of metadata key-value pairs.

​
Response Examples

[
  {
    "key": "Software Engineer",
    "value": 1542
  },
  {
    "key": "Product Manager",
    "value": 987
  },
  {
    "key": "Data Scientist",
    "value": 654
  },
  {
    "key": "Engineering Manager",
    "value": 432
  },
  {
    "key": "VP of Engineering",
    "value": 156
  }
]

​
Usage Examples

​
Get default metadata

curl -X GET "https://api.lance.work/api/v1/operations/autocomplete/person-metadata" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Get first page with custom size

curl -X GET "https://api.lance.work/api/v1/operations/autocomplete/person-metadata?size=50&page=0" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Paginate through metadata

curl -X GET "https://api.lance.work/api/v1/operations/autocomplete/person-metadata?page=1&size=25" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Notes

  • Results are cached for 7 days to improve performance. The cache is shared across all users in the organization.
  • Unlike other autocomplete endpoints that return paginated objects with content, this endpoint returns a flat array of key-value pairs.
  • Use this endpoint to build analytics dashboards or to understand the distribution of persons by various attributes in your database.