For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
    • Overview
  • Runtype API
      • POSTBulk delete records
      • GETList records
      • POSTCreate record
      • GETDiscover record schema
      • GETGet field values
      • POSTPreview record filter
      • GETGet record details
      • PUTUpdate record
      • DELDelete record
      • GETGet record step results
      • GETGet record costs
      • GETGet record results
      • DELDelete record result
      • POSTBulk edit records
      • POSTUpload CSV records
Dashboard
LogoLogo
Runtype APIRecords

Get field values

GET
/v1/records/field-values
GET
/v1/records/field-values
$curl -G https://api.runtype.com/v1/records/field-values \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d type=document \
>     -d field=author \
>     -d limit=5
1{
2  "type": "document",
3  "field": "author",
4  "values": [
5    {
6      "count": 42,
7      "value": "Alice Johnson"
8    },
9    {
10      "count": 37,
11      "value": "Bob Smith"
12    },
13    {
14      "count": 29,
15      "value": "Carol Lee"
16    },
17    {
18      "count": 15,
19      "value": "David Kim"
20    },
21    {
22      "count": 3,
23      "value": null
24    }
25  ],
26  "truncated": true
27}

Get top distinct values for a metadata field, with per-value counts.

Was this page helpful?
Previous

Preview record filter

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Query parameters

typestringRequired
fieldstringRequired
limitstringOptional

Response

Field values with counts
typestring
fieldstring
valueslist of objects
truncatedboolean

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error