Types

GET /public/v1/projects/{project_slug}/people/types

Return distinct person type values for the project's assigned Stylebook. Use this to populate filter dropdowns before calling List and search.

For the full catalog of allowed values and meanings, see Entity Meta → People. The response includes both catalog defaults and types stored on active canonical records.

Path parameters

Name	Type	Description
project_slug	string	Project slug

Query parameters

Name	Type	Default	Description
stylebook_slug	string	—	Optional compatibility check; when set, must match the project's assigned Stylebook

Response 200

{
  "types": ["elected_official", "other"]
}

Field	Type	Description
types	string[]	Distinct person type values, sorted alphabetically

Example

curl "https://api.{organization_slug}.backfield.news/public/v1/projects/general/people/types" \
  -H "Authorization: Bearer bfk_your_project_api_key"

Errors

Status	When
400	stylebook_slug names a different Stylebook in the project organization
401	Missing or invalid API key
403	API key not valid for this project
404	Unknown project_slug or unknown/foreign stylebook_slug

Related

• Entity Meta → People — catalog values and meanings
• List and search — filter by person_type
• People overview