cURL
curl --request GET \
--url https://api.collective.work/{environment}/v1/profile/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.collective.work/{environment}/v1/profile/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.collective.work/{environment}/v1/profile/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.collective.work/{environment}/v1/profile/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.collective.work/{environment}/v1/profile/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.collective.work/{environment}/v1/profile/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.collective.work/{environment}/v1/profile/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "cm71yqftr00000ck0bpz3hpg1",
"firstname": "Jane",
"lastname": "Doe",
"pictureUrl": "https://pictures.example.com/jane.png",
"linkedinUrl": "https://www.linkedin.com/in/jane-doe",
"collectiveUrl": "https://app.collective.work/recruiter/search?profileId=cmjr2j27g2xzy6dgjauv8hbc1",
"title": "Senior Frontend Engineer",
"dailyRate": 650,
"yearlySalaryMin": 60000,
"yearlySalaryMax": 80000,
"availability": "AVAILABLE",
"workPreference": "REMOTE_ONLY",
"desiredContractType": "FREELANCER",
"location": {
"googleMapsPlaceId": "ChIJdw3OtdnQZ0cRziAfbWk74Go",
"country": "France",
"countryCode": "FR",
"label": "Paris, France",
"shortLabel": "Paris",
"latitude": 48.8566,
"longitude": 2.3522
},
"mobilities": [
{
"googleMapsPlaceId": "ChIJdw3OtdnQZ0cRziAfbWk74Go",
"country": "France",
"countryCode": "FR",
"label": "Paris, France",
"shortLabel": "Paris",
"latitude": 48.8566,
"longitude": 2.3522
}
],
"skills": [
"TypeScript",
"GraphQL"
],
"featuredSkills": [
"React"
],
"workExperiences": [
{
"title": "Senior Frontend Engineer",
"company": "Collective",
"companyLogoUrl": "https://logo.example.com/collective.png",
"startDate": "2021-01-01T00:00:00.000Z",
"endDate": "2023-06-30T00:00:00.000Z",
"description": "Led the design system team and migrated the app to React 18.",
"location": {
"googleMapsPlaceId": "ChIJdw3OtdnQZ0cRziAfbWk74Go",
"country": "France",
"countryCode": "FR",
"label": "Paris, France",
"shortLabel": "Paris",
"latitude": 48.8566,
"longitude": 2.3522
}
}
],
"intro": "Frontend engineer with 8 years building design systems.",
"educations": [
{
"school": "École Polytechnique",
"degreeName": "MSc Computer Science",
"field": "Computer Science",
"description": "Specialised in distributed systems and machine learning.",
"startDate": "2014-09-01T00:00:00.000Z",
"endDate": "2017-06-30T00:00:00.000Z"
}
],
"languages": [
{
"language": "English"
}
],
"certifications": [
{
"name": "AWS Certified Solutions Architect",
"companyName": "Amazon Web Services",
"issueDate": "2022-03-01T00:00:00.000Z"
}
],
"links": [
{
"name": "GitHub",
"url": "https://github.com/jane"
}
],
"emails": [
{
"email": "jane.doe@example.com"
}
],
"phones": [
{
"phoneNumber": "+33612345678",
"whatsappValidity": "VALID"
}
],
"cv": {
"fileName": "resume.pdf",
"contentType": "application/pdf",
"data": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC..."
}
}{
"message": [
"Monthly profile retrieval limit reached"
],
"statusCode": 402,
"error": "Payment Required"
}{
"message": [
"<string>"
],
"statusCode": 403,
"error": "Forbidden"
}{
"message": [
"Resource not found"
],
"statusCode": 404,
"error": "Not Found"
}{
"message": [
"Internal server error"
],
"statusCode": 500,
"error": "Internal Server Error"
}Profile API Endpoints
Get Profile
Retrieve the full profile of a talent, including contact details (emails and phone numbers with WhatsApp reachability) and the CV inline as base64. Typically called with an id returned in a talent search result.
This is a paid feature that must be activated on your organisation (PRO plan), separately from talent search. Full-profile retrievals are metered per organisation with a monthly cap — every call counts (there is no de-duplication). Learn more.
GET
/
profile
/
{id}
cURL
curl --request GET \
--url https://api.collective.work/{environment}/v1/profile/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.collective.work/{environment}/v1/profile/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.collective.work/{environment}/v1/profile/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.collective.work/{environment}/v1/profile/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.collective.work/{environment}/v1/profile/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.collective.work/{environment}/v1/profile/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.collective.work/{environment}/v1/profile/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "cm71yqftr00000ck0bpz3hpg1",
"firstname": "Jane",
"lastname": "Doe",
"pictureUrl": "https://pictures.example.com/jane.png",
"linkedinUrl": "https://www.linkedin.com/in/jane-doe",
"collectiveUrl": "https://app.collective.work/recruiter/search?profileId=cmjr2j27g2xzy6dgjauv8hbc1",
"title": "Senior Frontend Engineer",
"dailyRate": 650,
"yearlySalaryMin": 60000,
"yearlySalaryMax": 80000,
"availability": "AVAILABLE",
"workPreference": "REMOTE_ONLY",
"desiredContractType": "FREELANCER",
"location": {
"googleMapsPlaceId": "ChIJdw3OtdnQZ0cRziAfbWk74Go",
"country": "France",
"countryCode": "FR",
"label": "Paris, France",
"shortLabel": "Paris",
"latitude": 48.8566,
"longitude": 2.3522
},
"mobilities": [
{
"googleMapsPlaceId": "ChIJdw3OtdnQZ0cRziAfbWk74Go",
"country": "France",
"countryCode": "FR",
"label": "Paris, France",
"shortLabel": "Paris",
"latitude": 48.8566,
"longitude": 2.3522
}
],
"skills": [
"TypeScript",
"GraphQL"
],
"featuredSkills": [
"React"
],
"workExperiences": [
{
"title": "Senior Frontend Engineer",
"company": "Collective",
"companyLogoUrl": "https://logo.example.com/collective.png",
"startDate": "2021-01-01T00:00:00.000Z",
"endDate": "2023-06-30T00:00:00.000Z",
"description": "Led the design system team and migrated the app to React 18.",
"location": {
"googleMapsPlaceId": "ChIJdw3OtdnQZ0cRziAfbWk74Go",
"country": "France",
"countryCode": "FR",
"label": "Paris, France",
"shortLabel": "Paris",
"latitude": 48.8566,
"longitude": 2.3522
}
}
],
"intro": "Frontend engineer with 8 years building design systems.",
"educations": [
{
"school": "École Polytechnique",
"degreeName": "MSc Computer Science",
"field": "Computer Science",
"description": "Specialised in distributed systems and machine learning.",
"startDate": "2014-09-01T00:00:00.000Z",
"endDate": "2017-06-30T00:00:00.000Z"
}
],
"languages": [
{
"language": "English"
}
],
"certifications": [
{
"name": "AWS Certified Solutions Architect",
"companyName": "Amazon Web Services",
"issueDate": "2022-03-01T00:00:00.000Z"
}
],
"links": [
{
"name": "GitHub",
"url": "https://github.com/jane"
}
],
"emails": [
{
"email": "jane.doe@example.com"
}
],
"phones": [
{
"phoneNumber": "+33612345678",
"whatsappValidity": "VALID"
}
],
"cv": {
"fileName": "resume.pdf",
"contentType": "application/pdf",
"data": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC..."
}
}{
"message": [
"Monthly profile retrieval limit reached"
],
"statusCode": 402,
"error": "Payment Required"
}{
"message": [
"<string>"
],
"statusCode": 403,
"error": "Forbidden"
}{
"message": [
"Resource not found"
],
"statusCode": 404,
"error": "Not Found"
}{
"message": [
"Internal server error"
],
"statusCode": 500,
"error": "Internal Server Error"
}Authorizations
Your organization API key, available in Organisation settings.
Response
Profile retrieved successfully
Was this page helpful?

