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

# Change log

> List of changes made to the API during a development.

> [accordion] November 2026 (v3) — Profile Signal Fields
>
> New recruiting and job-seeking signals, deprecations, and absent-means-false booleans
>
> New fields on `profile_info`:
>
> | Key | Type | Description |
> | - | - | - |
> | `profile_info.recruiting_signals` | boolean | `true` when the person shows signals that they recruit. Same value as `hiring`. |
> | `profile_info.job_seeking_signals` | boolean | `true` when the person shows signals that they look for a job. Same value as `open_to_work`. |
>
> Search filters accept `profile_info.recruiting_signals` and `profile_info.job_seeking_signals`. See [OpenSearch Mappings (v3)](https://docs.theswarm.com/docs/enrichment-data/profile/mappings-v3.md#boolean-signal-fields).
>
> Deprecated fields:
>
> | Key | Replacement | Removal |
> | - | - | - |
> | `profile_info.hiring` | `profile_info.recruiting_signals` | After 2026/12/21 |
> | `profile_info.open_to_work` | `profile_info.job_seeking_signals` | After 2026/12/21 |
>
> **Absent means false.** `hiring`, `open_to_work`, `recruiting_signals`, `job_seeking_signals`, and `probably_fake` appear only when their value is `true`. A missing field means `false`. This applies to profile fetch, search, fetch-refresh, and MCP.
>
> > [!WARNING]
> >
> > **Behavior change for `probably_fake`:** the API no longer returns `"probably_fake": false`. If your code checks for an explicit `false`, treat a missing field as `false` instead.

> [accordion] June 2026 (v3) — Profile Index Changes
>
> OpenSearch profile mapping changes for v3
>
> New fields added to the v3 profile index:
>
> | Key | Type | Description |
> | - | - | - |
> | `profile_info.hiring` | boolean | Signals that the profile is actively hiring. |
> | `profile_info.open_to_work` | boolean | Signals that the profile is open to new opportunities. |
> | `team_connections.origins` | keyword (nested) | Provenance of each team connection. Query with a `nested` clause scoped to your `team_connections.team_id`. |
> | `connections.origins` | keyword (nested) | Provenance on the `connections` array — the query-side counterpart of the response-side `connections[].sources[].origin`. |

> [accordion] June 2026 (v3) — Relationships Changes
>
> POST /v3/relationships now supports limit and pagination\_token
>
> The [Relationships](https://docs.theswarm.com/docs/endpoints/v3/relationships.md) endpoint now supports cursor-based pagination:
>
> | Field | Location | Description |
> | - | - | - |
> | `limit` | Request body | Number of results per page. Default: 100, max: 1000. |
> | `pagination_token` | Request body | Token from the previous response to retrieve the next page. |
> | `pagination_token` | Response body | Returned when more pages are available. Absent on the last page. |
>
> The previous cap of 50 results per response has been removed. See [Relationships — Pagination](https://docs.theswarm.com/docs/intelligence/relationships.md#pagination) for usage examples.

> [accordion] June 2026 (v3) — API Specification Refresh
>
> Schema deltas in the latest v3 OpenAPI
>
> Profile schema:
>
> * **Renamed** `profile_info.current_seniority` → `current_seniorities`, and `experience[].seniority` → `seniorities`. Both are arrays — a profile can carry multiple seniority levels.
> * **Added** `profile_info.location_locality`, `location_region`, `location_country`, `location_continent` (city / state / country / continent of the profile location).
> * **Expanded** `profile_info.social_media[]` with `entity_id`, `connections`, `followers`, `join_date`.
> * **Removed** `profile_info.linkedin_experience_count`, `profile_info.linkedin_education_count`, `profile_info.investor_data`.
> * `experience[].status` is now **required**.
> * `experience[].company.locations[].headquarter` → `is_primary`; the inline `experience[].company.workforce.headcount` block was removed.
>
> Company schema:
>
> * **Removed** top-level `company_info.industry`, `website`, `data_updated_at`, and `size.class`.
> * `workforce` is now a **single object** (was an array of one item).
> * Investor fields (`type`, `specialities`, `investments`, `geography_focus`) moved into a nested `investor` object.
> * Funding amount fields (`last_round_amount_usd`, `rounds[].amount_usd`, `total_funding_amount_usd`) are now `number` (was `integer`).
> * `crunchbase_id` dropped from funding investor entries.
> * `company_info.name` is now **required**.
> * Company locations carry `is_primary`.
>
> Endpoints:
>
> * `POST /v3/profiles/fetch` and `POST /v3/companies/fetch` now cap identifier arrays at **1,000 entries per request**.
> * `POST /v3/profiles/search` and `POST /v3/companies/search` enforce `from >= 0`.
> * All `/v3/*` endpoints can return **`402 Payment Required`** when the team's API credit allowance is exceeded.

> [accordion] November 2024
>
> Changes in the existing fields
>
> We made some field name changes to the existing fields
>
> | Key | Change description |
> | - | - |
> | `job_title` | Filed name change to `current_title` |
> | `job_title_role` | Filed name change to `current_job_function` |
> | `job_seniority` | Filed name change to `current_seniorities` (now plural / array) |
> | `job_company_id` | Filed name change to `current_company_id` |
> | `job_company_name` | Filed name change to `current_company_name` |
> | `job_company_size` | Filed name change to `current_company_size` |
> | `job_company_website` | Filed name change to `current_company_website` |
> | `job_company_industry` | Filed name change to `current_company_industry` |
> | `job_company_linkedin_slugs` | Filed name change to `current_company_linkedin_slugs` |
> | `job_company_location_name` | Filed name change to `current_company_location` |
> | `job_company_location_country` | Filed name change to `current_company_location_country` |
> | `job_start_date` | Filed name change to `current_start_date` |
> | `recent_job_title` | Filed name change to `recent_title` |
> | `all_time_job_title` | Filed name change to `all_time_title` |
> | `experience.is_primary` | Filed name change to `experience.is_current` |
> | `location_name` | Filed name change to `current_location` |
> | `location_names` | Filed name change to `other_location` |
>
> There are some fields that have been removed
>
> | Key | Change description |
> | - | - |
> | `education.school.id` | It was not a persistent ID and was not maintained. We recommend  using `school.name` whenever you need to search by a specific university. |
> | `education.school.type` | Removed due to low coverage. |
> | `linkedin_username` | Field was replaced by `linkedin_usernames`. |
> | `experience.company.linkedin_slug` | Field was replaced by `experience.company.linkedin_slugs`. |
> | `job_company_linkedin_slug` | Field was replaced by `current_company_linkedin_slugs`. |

> [accordion] November 2024
>
> Changes in the existing fields
>
> | Key | Change description |
> | - | - |
> | `fullName` | Filed name change to `full_name` |
> | `firstName` | Filed name change to `first_name` |
> | `lastName` | Filed name change to `last_name` |
> | `linkedinUrl` | Filed name change to `linkedin_url` |
> | `workEmail` | Filed name change to `work_email` |
> | `personalEmails` | Filed name change to `personal_emails` |
> | `industry` | Filed name change to `current_company_industry` |
> | `jobTitle` | Filed name change to `current_title` |
> | `jobCompanyId` | Filed name change to `current_company_id` |
> | `jobCompanyName` | Filed name change to `current_company_name` |
> | `jobCompanyWebsite` | Filed name change to `current_company_website` |
> | `jobCompanySize` | Filed name change to `current_company_size` |
> | `jobCompanyIndustry` | Filed name change to `current_company_industry` |
> | `jobCompanyLocationName` | Filed name change to `current_company_location` |
> | `jobCompanyLinkedinUrl` | Filed name change to `current_company_linkedin_url` |
> | `experience.isPrimary` | Filed name change to `experience.is_primary` |
> | `experience.startDate` | Filed name change to `experience.start_date` |
> | `experience.endDate` | Filed name change to `experience.end_date` |
> | `experience.companyId` | Filed name change to `experience.company_id` |
> | `experience.company.canonicalName` | Filed name change to `experience.company.canonical_name` |
> | `experience.company.networks` | Filed name change to `experience.company.social_media` |
> | `experience.company.locations.streetAddress` | Filed name change to `experience.company.locations.street_address` |
> | `experience.company.locations.postalCode` | Filed name change to `experience.company.locations.postal_code` |
> | `locationName` | Filed name change to `current_location` |
> | `locationNames` | Filed name change to `other_locations` |
> | `education.startDate` | Filed name change to `education.start_date` |
> | `education.endDate` | Filed name change to `education.end_date` |
> | `profiles` | Filed name change to `social_media` |
> | `latestRoleChangeAt` | Filed name change to `latest_role_change_at` |
> | `currentJobUpdatedAt` | Filed name change to `current_job_updated_at` |
> | `updatedAt` | Filed name change to `updated_at` |
> | `createdAt` | Filed name change to `created_at` |


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