Models
Profile
Overview of the data model representing a profile returned by the Fetch endpoint
Explore the detailed breakdown of each item model component, complete with properties and their descriptions.
Response Keys
The Profile JSON response is built around six core keys listed below:
| Key | Description |
|---|---|
| id | ID of the person assigned by The Swarm that was previously returned by the /search endpoint. |
profile_info | Detailed profile data, e.g. work experience, education, etc. |
connections | A list of Team Members that are connected to the person. A team member can be identified by their email address or LinkedIn user name (if added LinkedIn url at the registration) |
lists | A list of Lists that the person is assigned to along with the status in the List. |
notes | All notes that have been added to the person by any of the team members |
tags | All tags assigned to the profile by any of the team members. |
JSON Schema
Here is the full JSON Schema for the data model returned by the Fetch endpoint. This schema outlines the structure and data types of the JSON response, offering a clear and detailed blueprint of the profile model.
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"connections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"userId": {
"type": "string"
},
"user_email": {
"type": "string"
},
"user_linkedin_name": {
"type": "string"
},
"created_at": {
"type": "string"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"origin": {
"type": "string"
},
"network": {
"type": "string"
}
}
}
},
"connection_strength": {
"type": "number"
},
"manual_strength": {
"type": "number"
},
"strength_normalized": {
"type": "integer"
}
}
}
},
"lists": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"status": {
"type": "string"
}
}
}
},
"notes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"content": {
"type": "string"
}
}
}
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
},
"profile_info": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"full_name": {
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"linkedin_url": {
"type": "string"
},
"work_email": {
"type": "string"
},
"personal_emails": {
"type": "array",
"items": {
"type": "string"
}
},
"current_title": {
"type": "string"
},
"current_company_id": {
"type": "string"
},
"current_company_name": {
"type": "string"
},
"current_company_website": {
"type": "string"
},
"current_company_size": {
"type": "object",
"properties": {
"min": {
"type": "integer"
},
"max": {
"type": "integer"
}
}
},
"current_company_industry": {
"type": "string"
},
"current_company_location": {
"type": "string"
},
"current_company_linkedin_url": {
"type": "string"
},
"experience": {
"type": "array",
"items": {
"type": "object",
"properties": {
"is_current": {
"type": "boolean"
},
"company_id": {
"type": "string"
},
"company": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"canonical_name": {
"type": "string"
},
"name": {
"type": "string"
},
"founded": {
"type": "string"
},
"industry": {
"type": "string"
},
"website": {
"type": "string"
},
"size": {
"type": "object",
"properties": {
"min": {
"type": "integer"
},
"max": {
"type": "integer"
}
}
},
"social_media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"network": {
"type": "string"
},
"id": {
"type": "string"
},
"url": {
"type": "string"
}
}
}
},
"locations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"country": {
"type": "string"
},
"streetAddress": {
"type": "string"
},
"postalCode": {
"type": "string"
},
"headquarter": {
"type": "boolean"
}
}
}
}
}
},
"title": {
"type": "string"
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
}
}
}
},
"latest_role_change_at": {
"type": "string"
},
"latest_company_change_at": {
"type": "string"
},
"current_location": {
"type": "string"
},
"other_locations": {
"type": "array",
"items": {
"type": "string"
}
},
"skills": {
"type": "array",
"items": {
"type": "string"
}
},
"education": {
"type": "array",
"items": {
"type": "object",
"properties": {
"school": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"location": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"country": {
"type": "string"
}
}
},
"website": {
"type": "string"
}
}
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"majors": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"social_media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"network": {
"type": "string"
},
"url": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
},
"current_job_updated_at": {
"type": "string"
},
"updated_at": {
"type": "string"
},
"created_at": {
"type": "string"
}
}
}
}
}
Profile Example
An example of the profile returned by the Profile Fetch endpoint is given below.
{
"id": "b8d4ba05-5158-4d80-a0a7-c8e650f7c95c",
"connections": [
{
"user_id": "68576a63-c8c3-4c92-88e8-b89a532ae3fa",
"user_email": "michal@theswarm.com",
"user_linkedin_name": "",
"created_at": "2024-03-22T15:15:17.525907Z",
"sources": [
{
"origin": "plugin",
"network": "linkedin"
}
],
"connection_strength": 0.7084125480166015,
"manual_strength": null,
"strength_normalized": 1
}
],
"lists": [
{
"id": "58bb21af-6777-4a5d-a763-45df10258727",
"name": "Tech Leaders",
"status": "suggested"
}
],
"notes": [
{
"id": "a1037c27-b773-4c19-b987-c8854db6701d",
"content": "Cool guy. Met him while traveling to Bali."
}
],
"tags": [
{
"id": "faa5ba2a-23e9-40fd-8efe-720a2b6246d3",
"name": "Contact soon"
}
],
"profile_info": {
"id": "f0f9f467-7798-4b15-a913-3d1375c85390",
"full_name": "David Connors",
"first_name": "David",
"last_name": "Connors",
"current_location": "San Francisco, California, United States",
"linkedin_url": "linkedin.com/in/connorsdavid",
"work_email": "david@theswarm.com",
"personal_emails": [
"davidjulianconnors@gmail.com"
],
"current_title": "Co-Founder & CEO",
"current_company_id": "09d9c510-c9f6-4c6e-9e62-fe5fedbeda87",
"current_company_name": "The Swarm",
"current_company_website": "theswarm.com",
"current_company_size": {
"min": 11,
"max": 50
},
"current_company_industry": "Computer Software",
"current_company_location": "San Francisco, California, United States",
"current_company_linkedin_url": "linkedin.com/company/wearetheswarm",
"experience": [
{
"is_current": true,
"company_id": "09d9c510-c9f6-4c6e-9e62-fe5fedbeda87",
"company": {
"id": "09d9c510-c9f6-4c6e-9e62-fe5fedbeda87",
"canonical_name": "wearetheswarm",
"name": "The Swarm",
"founded": "2021-01-01T00:00:00Z",
"industry": "Computer Software",
"website": "theswarm.com",
"size": {
"min": 11,
"max": 50
},
"social_media": [
{
"network": "linkedin",
"id": "76647462",
"url": "linkedin.com/company/wearetheswarm"
},
{
"network": "twitter",
"url": "twitter.com/wearetheswarm"
}
],
"locations": [
{
"name": "San Francisco, California, United States",
"city": "San Francisco",
"state": "California",
"country": "United States",
"street_address": "548 Market Street",
"postal_code": "94104",
"headquarter": true
}
]
},
"title": "Co-Founder & CEO",
"start_date": "2021-08-01"
},
{
"company_id": "f5d8c962-7987-4786-8754-5c85f8ba4bc3",
"company": {
"id": "f5d8c962-7987-4786-8754-5c85f8ba4bc3",
"canonical_name": "sequoia",
"name": "Sequoia Capital",
"founded": "1972-01-01T00:00:00Z",
"industry": "Venture Capital & Private Equity",
"website": "sequoiacap.com",
"size": {
"min": 51,
"max": 200
},
"social_media": [
{
"network": "linkedin",
"id": "11190",
"url": "linkedin.com/company/sequoia"
},
{
"network": "facebook",
"url": "facebook.com/sequoiacap"
},
{
"network": "twitter",
"url": "twitter.com/sequoia"
}
],
"locations": [
{
"name": "Menlo Park, California, United States",
"city": "Menlo Park",
"state": "California",
"country": "United States",
"street_address": "2800 Sand Hill Road",
"postal_code": "94025",
"headquarter": true
}
]
},
"title": "Founder-in-Residence",
"start_date": "2019-06-01",
"end_date": "2021-08-01"
},
{
"company_id": "b91ca025-b55e-485d-9838-40b64e9402d5",
"company": {
"id": "b91ca025-b55e-485d-9838-40b64e9402d5",
"canonical_name": "automately",
"name": "automately.io",
"founded": "2017-01-01T00:00:00Z",
"industry": "Information Technology and Services",
"website": "automately.io",
"size": {
"min": 1,
"max": 10
},
"social_media": [
{
"network": "linkedin",
"id": "17934171",
"url": "linkedin.com/company/automately"
}
],
"locations": [
{
"name": "Los Angeles, California, United States",
"city": "Los Angeles",
"state": "California",
"country": "United States",
"street_address": "2219 Main Street",
"postal_code": "90405",
"headquarter": true
}
]
},
"title": "Co-Founder & CEO",
"start_date": "2016-11-01",
"end_date": "2019-06-01"
},
{
"company": {
"name": "RevDev.io"
},
"title": "Co-Founder",
"start_date": "2018-01-01",
"end_date": "2019-01-01"
},
{
"company_id": "bcdfc1cb-7e6b-4e61-825b-c9306adcecb0",
"company": {
"id": "bcdfc1cb-7e6b-4e61-825b-c9306adcecb0",
"canonical_name": "docmatter",
"name": "Docmatter",
"founded": "0000-01-01T00:00:00Z",
"industry": "Hospital & Health Care",
"website": "docmatter.com",
"size": {
"min": 11,
"max": 50
},
"social_media": [
{
"network": "linkedin",
"id": "3242905",
"url": "linkedin.com/company/docmatter"
},
{
"network": "facebook",
"url": "facebook.com/docmatter"
},
{
"network": "twitter",
"url": "twitter.com/docmatterinc"
}
],
"locations": [
{
"name": "San Francisco, California, United States",
"city": "San Francisco",
"state": "California",
"country": "United States",
"street_address": "560 Davis Street, Suite 150",
"postal_code": "94111",
"headquarter": true
}
]
},
"title": "Growth",
"start_date": "2015-09-01",
"end_date": "2016-11-01"
},
{
"company_id": "6963a3df-a185-4c69-88fe-7e2b95786688",
"company": {
"id": "6963a3df-a185-4c69-88fe-7e2b95786688",
"canonical_name": "pwc",
"name": "PWC",
"founded": "1998-01-01T00:00:00Z",
"industry": "Accounting",
"website": "pwc.com",
"size": {
"min": 10001
},
"social_media": [
{
"network": "linkedin",
"id": "1044",
"url": "linkedin.com/company/pwc"
},
{
"network": "facebook",
"url": "facebook.com/execpress"
},
{
"network": "twitter",
"url": "twitter.com/pwc_llp"
}
],
"locations": [
{
"name": "New York, New York, United States",
"city": "New York",
"state": "New York",
"country": "United States",
"street_address": "300 Madison Avenue",
"postal_code": "10017",
"headquarter": true
}
]
},
"title": "Management Consultant | Digital and Emerging Technologies",
"start_date": "2014-06-01",
"end_date": "2015-11-01"
},
{
"company_id": "c3f4f899-85b0-4038-8eda-92c2dc654ee7",
"company": {
"id": "c3f4f899-85b0-4038-8eda-92c2dc654ee7",
"canonical_name": "management-consultancies-association",
"name": "Management Consultancies Association",
"founded": "1956-01-01T00:00:00Z",
"industry": "Management Consulting",
"website": "McA.org.uk",
"size": {
"min": 1,
"max": 10
},
"social_media": [
{
"network": "linkedin",
"id": "803387",
"url": "linkedin.com/company/management-consultancies-association"
},
{
"network": "facebook",
"url": "facebook.com/themcauk"
},
{
"network": "twitter",
"url": "twitter.com/themca_uk"
}
],
"locations": [
{
"name": "London, London, United Kingdom",
"city": "London",
"state": "London",
"country": "United Kingdom",
"headquarter": true
}
]
},
"title": "Vice Chair",
"start_date": "2014-05-01",
"end_date": "2015-08-01"
}
],
"other_locations": [
"San Francisco, California, United States"
],
"skills": [
"Analysis",
"Management Consulting",
"Business Strategy",
"Project Management",
"Management",
"Research",
"Data Analysis",
"Financial Modeling",
"Networking",
"Market Research",
"Microsoft Excel",
"Analytical Skills",
"Project Planning",
"Strategic Planning",
"Stakeholder Management",
"Operations Management",
"Operational Excellence",
"Event Management",
"Strategic Consulting",
"Strategy",
"Consulting"
],
"education": [
{
"school": {
"name": "University of Melbourne"
},
"start_date": "2007",
"end_date": "2010",
"degrees": [
"Bachelor of Commerce (Degree with Honours)"
],
"majors": [
""
]
},
{
"school": {
"name": "UC Santa Barbara"
},
"start_date": "2009",
"end_date": "2009",
"degrees": [
"Bachelor's Degree"
],
"majors": [
"Business/Managerial Economics"
]
},
{
"school": {
"name": "Uc Santa Barbara",
"location": {
"name": "Santa Barbara, California, United States",
"city": "Santa Barbara",
"state": "California",
"country": "United States"
},
"website": "ucsb.edu"
},
"start_date": "2009",
"end_date": "2009",
"degrees": [
"Bachelors"
],
"majors": [
"Economics",
"Business"
]
},
{
"school": {
"name": "Wesley College, Delaware",
"location": {
"name": "Dover, Delaware, United States",
"city": "Dover",
"state": "Delaware",
"country": "United States"
},
"website": "wesley.edu"
},
"start_date": "2001",
"end_date": "2006"
}
],
"social_media": [
{
"network": "linkedin",
"url": "www.linkedin.com/in/connorsdavid"
},
{
"network": "linkedin"
}
],
"latest_role_change_at": "2021-08-01",
"latest_company_change_at": "2021-08-01",
"current_job_updated_at": "2024-11-02T18:46:20.36853Z",
"updated_at": "2024-11-02T18:46:20.310219Z",
"created_at": "2023-07-25T18:30:44.131706Z"
}
}
On this page