> ## Documentation Index
> Fetch the complete documentation index at: https://www.forager.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Forager is a REST API for B2B people, company and job post data: contact lookups (phone numbers, personal emails, work emails), person, company and job post search, and bulk data feeds.
> Server: https://api-v2.forager.ai. Send the API key in the X-API-KEY header. Most paths include {account_id}. Read FORAGER_API_KEY and FORAGER_ACCOUNT_ID from the environment; never put the key in client-side code, logs or prompts.
> To add Forager to a project, follow https://www.forager.ai/docs/guides/agent-quickstart.md. To pick an endpoint, read https://www.forager.ai/docs/guides/choose-an-endpoint.md. For end-to-end builds, see https://www.forager.ai/docs/recipes/overview.md.
> Most requests spend credits. Do not guess costs; use https://www.forager.ai/docs/api-overview/credit-pricing.md and ask the user before spending credits.
> Use only endpoints and fields defined in https://www.forager.ai/docs/openapi.yaml. Forager has no MCP server for the API yet; the /mcp endpoint on this site searches the documentation only.

# Role (Person Data Feed)

> Fields of the Role object in the Forager Person Data Feed schema, version 2.0.4 (latest).

Represents a job role or professional position.

Part of the Person Data Feed schema, version 2.0.4 (latest). The full JSON for every version is on the [Schema](https://www.forager.ai/docs/data-license/v2/schema.md) page.

| Field | Type | Required | Description |
| - | - | - | - |
| `id` | integer | yes | |
| `linkedin_id` | integer | no | |
| `role_title` | string | no | |
| `description` | string | no | |
| `start_date` | string (date) | no | |
| `end_date` | string (date) | no | |
| `organization_id` | integer | no | |
| `organization_name` | string | no | |
| `employment_type` | string | no | The employment type of the person in the organization. See [`employment_type` codes](#employment_type-codes). |
| `date_updated` | string (date-time) | no | |
| `organization_website` | string | no | |
| `organization_domain` | string | no | |
| `organization_linkedin_info_public_identifier` | string | no | |
| `organization_industry` | string | no | |
| `organization_linkedin_id` | integer | no | |
| `location` | string | no | |

### `employment_type` codes

Codes used in `employment_type`.

| Code | Meaning |
| - | - |
| 1 | `permanent` |
| 2 | `contract` |
| 3 | `self_employed` |
| 11 | `part_time` |
| 12 | `full_time` |
| 13 | `permanent_full_time` |
| 14 | `permanent_part_time` |
| 15 | `contract_full_time` |
| 16 | `contract_part_time` |
| 18 | `internship` |
| 19 | `apprenticeship` |
| 20 | `freelance` |
| 21 | `seasonal` |
| 22 | `on_call` |
| 23 | `co_op` |
| 24 | `lifetime_civil_servant` |
| 25 | `temporary_civil_servant` |
| 26 | `recurring_status` |
| 28 | `civil_service_internship` |
| 29 | `indirect_contract` |
| 30 | `leadership_program` |
| 31 | `work_study` |
| 32 | `international_corporate_n_administration_volunteer` |
| 33 | `direct_contract` |
| 500 | `no_title_error` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.