curl --request GET \
--url https://my.jobin.cloud/api/openapi/v1/contacts/{contactId} \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://my.jobin.cloud/api/openapi/v1/contacts/{contactId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://my.jobin.cloud/api/openapi/v1/contacts/{contactId}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)$headers=@{}
$headers.Add("x-api-key", "<api-key>")
$response = Invoke-WebRequest -Uri 'https://my.jobin.cloud/api/openapi/v1/contacts/{contactId}' -Method GET -Headers $headers{
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"firstName": "<string>",
"middleName": "<string>",
"lastName": "<string>",
"workEmail": "<string>",
"privateEmail": "<string>",
"otherEmails": [
"<string>"
],
"workPhone": "<string>",
"privatePhone": "<string>",
"otherPhones": [
"<string>"
],
"workMobilePhone": "<string>",
"privateMobilePhone": "<string>",
"otherMobilePhones": [
"<string>"
],
"socialUrls": [
"<string>"
],
"currentTitle": "<string>",
"currentCompany": "<string>",
"currentCompanyFrom": "2023-11-07T05:31:56Z",
"currentCompanyTo": "2023-11-07T05:31:56Z",
"currentCompanyTenureYears": 123,
"currentCompanyUrl": "<string>",
"currentCompanySocialUrl": "<string>",
"location": {
"fullAddress": "<string>",
"address": "<string>",
"addressLine2": "<string>",
"city": "<string>",
"state": "<string>",
"region": "<string>",
"country": "<string>",
"countryCode": "<string>",
"postalCode": "<string>"
},
"industry": "<string>",
"seniority": "<string>",
"managementLevel": "<string>",
"previousTitle": "<string>",
"previousCompany": "<string>",
"previousCompanySocialUrl": "<string>",
"headline": "<string>",
"summary": "<string>",
"openProfile": true,
"openToWork": true,
"connectionLevels": [
{
"jobinUser": {
"id": "<string>",
"firstName": "<string>",
"lastName": "<string>"
},
"connectionLevel": "1st"
}
],
"currentCampaign": {
"campaignId": "<string>",
"stagePositionCode": "<string>"
},
"tags": [
{
"_id": "<string>",
"value": "<string>",
"iconName": "<string>",
"color": "<string>"
}
],
"skills": [
{
"value": "<string>",
"skillType": "<string>",
"level": 123,
"topSkill": true
}
],
"education": [
{
"school": "<string>",
"schoolSocialUrl": "<string>",
"degreeLevel": "<string>",
"degrees": [
"<string>"
],
"fieldOfStudy": "<string>",
"majors": [
"<string>"
],
"minors": [
"<string>"
],
"period": {
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"isCurrent": true
}
}
],
"experiences": [
{
"title": "<string>",
"company": "<string>",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"isCurrent": true,
"location": {
"fullAddress": "<string>",
"address": "<string>",
"addressLine2": "<string>",
"city": "<string>",
"state": "<string>",
"region": "<string>",
"country": "<string>",
"countryCode": "<string>",
"postalCode": "<string>"
},
"employmentType": "<string>",
"description": "<string>"
}
],
"languages": [
{
"value": "<string>",
"level": 123,
"note": "<string>"
}
],
"volunteering": [
{
"roleTitle": "<string>",
"organization": {
"name": "<string>",
"socialUrl": "<string>",
"companyWebsite": "<string>",
"employeeCountRange": "<string>"
},
"cause": "<string>",
"description": "<string>",
"location": {
"fullAddress": "<string>",
"address": "<string>",
"addressLine2": "<string>",
"city": "<string>",
"state": "<string>",
"region": "<string>",
"country": "<string>",
"countryCode": "<string>",
"postalCode": "<string>"
},
"period": {
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"isCurrent": true
}
}
],
"accomplishments": [
{
"value": "<string>",
"type": "<string>",
"issuer": "<string>",
"description": "<string>",
"date": "2023-11-07T05:31:56Z",
"organization": {
"name": "<string>",
"socialUrl": "<string>",
"companyWebsite": "<string>",
"employeeCountRange": "<string>"
}
}
],
"customFieldList": [
{
"_id": "<string>",
"fieldName": "<string>",
"value": "<string>"
}
],
"source": "<string>",
"sourceType": "<string>",
"unsubscribed": true
}{
"statusCode": 429,
"error": "Too Many Requests",
"message": "<string>",
"retryAfterSeconds": 123
}Get Contact
Fetch one Jobin contact by identifier, including integration-friendly sequence and profile fields.
curl --request GET \
--url https://my.jobin.cloud/api/openapi/v1/contacts/{contactId} \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://my.jobin.cloud/api/openapi/v1/contacts/{contactId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://my.jobin.cloud/api/openapi/v1/contacts/{contactId}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)$headers=@{}
$headers.Add("x-api-key", "<api-key>")
$response = Invoke-WebRequest -Uri 'https://my.jobin.cloud/api/openapi/v1/contacts/{contactId}' -Method GET -Headers $headers{
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"firstName": "<string>",
"middleName": "<string>",
"lastName": "<string>",
"workEmail": "<string>",
"privateEmail": "<string>",
"otherEmails": [
"<string>"
],
"workPhone": "<string>",
"privatePhone": "<string>",
"otherPhones": [
"<string>"
],
"workMobilePhone": "<string>",
"privateMobilePhone": "<string>",
"otherMobilePhones": [
"<string>"
],
"socialUrls": [
"<string>"
],
"currentTitle": "<string>",
"currentCompany": "<string>",
"currentCompanyFrom": "2023-11-07T05:31:56Z",
"currentCompanyTo": "2023-11-07T05:31:56Z",
"currentCompanyTenureYears": 123,
"currentCompanyUrl": "<string>",
"currentCompanySocialUrl": "<string>",
"location": {
"fullAddress": "<string>",
"address": "<string>",
"addressLine2": "<string>",
"city": "<string>",
"state": "<string>",
"region": "<string>",
"country": "<string>",
"countryCode": "<string>",
"postalCode": "<string>"
},
"industry": "<string>",
"seniority": "<string>",
"managementLevel": "<string>",
"previousTitle": "<string>",
"previousCompany": "<string>",
"previousCompanySocialUrl": "<string>",
"headline": "<string>",
"summary": "<string>",
"openProfile": true,
"openToWork": true,
"connectionLevels": [
{
"jobinUser": {
"id": "<string>",
"firstName": "<string>",
"lastName": "<string>"
},
"connectionLevel": "1st"
}
],
"currentCampaign": {
"campaignId": "<string>",
"stagePositionCode": "<string>"
},
"tags": [
{
"_id": "<string>",
"value": "<string>",
"iconName": "<string>",
"color": "<string>"
}
],
"skills": [
{
"value": "<string>",
"skillType": "<string>",
"level": 123,
"topSkill": true
}
],
"education": [
{
"school": "<string>",
"schoolSocialUrl": "<string>",
"degreeLevel": "<string>",
"degrees": [
"<string>"
],
"fieldOfStudy": "<string>",
"majors": [
"<string>"
],
"minors": [
"<string>"
],
"period": {
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"isCurrent": true
}
}
],
"experiences": [
{
"title": "<string>",
"company": "<string>",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"isCurrent": true,
"location": {
"fullAddress": "<string>",
"address": "<string>",
"addressLine2": "<string>",
"city": "<string>",
"state": "<string>",
"region": "<string>",
"country": "<string>",
"countryCode": "<string>",
"postalCode": "<string>"
},
"employmentType": "<string>",
"description": "<string>"
}
],
"languages": [
{
"value": "<string>",
"level": 123,
"note": "<string>"
}
],
"volunteering": [
{
"roleTitle": "<string>",
"organization": {
"name": "<string>",
"socialUrl": "<string>",
"companyWebsite": "<string>",
"employeeCountRange": "<string>"
},
"cause": "<string>",
"description": "<string>",
"location": {
"fullAddress": "<string>",
"address": "<string>",
"addressLine2": "<string>",
"city": "<string>",
"state": "<string>",
"region": "<string>",
"country": "<string>",
"countryCode": "<string>",
"postalCode": "<string>"
},
"period": {
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"isCurrent": true
}
}
],
"accomplishments": [
{
"value": "<string>",
"type": "<string>",
"issuer": "<string>",
"description": "<string>",
"date": "2023-11-07T05:31:56Z",
"organization": {
"name": "<string>",
"socialUrl": "<string>",
"companyWebsite": "<string>",
"employeeCountRange": "<string>"
}
}
],
"customFieldList": [
{
"_id": "<string>",
"fieldName": "<string>",
"value": "<string>"
}
],
"source": "<string>",
"sourceType": "<string>",
"unsubscribed": true
}{
"statusCode": 429,
"error": "Too Many Requests",
"message": "<string>",
"retryAfterSeconds": 123
}contactId.Authorizations
Primary public authentication method. Create keys in Jobin.cloud under Workgroups > Integrations > Custom integration.
Path Parameters
Jobin contact identifier.
Response
Contact
Integration-friendly contact representation used by the public OpenAPI surface.
Jobin contact identifier.
When the contact was created in Jobin.
When the contact was last updated in Jobin.
Contact first name.
Contact middle name.
Contact last name.
Primary work email when available.
Primary private email when available.
Additional email addresses associated with the contact.
Primary work landline phone number when available.
Primary private landline phone number when available.
Additional landline phone numbers associated with the contact.
Primary work mobile phone number when available.
Primary private mobile phone number when available.
Additional mobile phone numbers associated with the contact.
Social and professional profile URLs for the contact.
Current role title from the contact's main professional experience.
Current company name from the contact's main professional experience.
Start date of the contact's current main professional experience when available.
End date stored on the contact's current main professional experience when available.
Denormalized current-company tenure in years. Recruiters often call this tenure or years at current company.
Current company website URL when available.
Current company profile URL when available.
Contact location shown in Jobin; falls back to current-role location when no person location exists.
Show child attributes
Show child attributes
industry stored on the contact.
Normalized seniority/career level for the current role when available.
Management level for the current role when available.
Most recent previous role title when Jobin has work history.
Most recent previous company name when Jobin has work history.
Most recent previous company profile URL when available.
stored headline/title value.
summary, bio, or enriched profile summary.
if the profile is marked as open profile/open link.
if the contact is marked as open to work.
All Jobin-user connection levels available inside the authenticated workgroup.
Show child attributes
Show child attributes
Current Jobin campaign/sequence assignment for the contact.
Show child attributes
Show child attributes
Tags attached to the contact in Jobin.
Show child attributes
Show child attributes
Skills attached to the contact.
Show child attributes
Show child attributes
Education history attached to the contact.
Show child attributes
Show child attributes
Full professional work history for single-contact detail reads. Contact list responses stay compact and may omit this field.
Show child attributes
Show child attributes
Languages attached to the contact.
Show child attributes
Show child attributes
Volunteer experience attached to the contact.
Show child attributes
Show child attributes
Accomplishments, certifications, awards, or similar profile items attached to the contact.
Show child attributes
Show child attributes
Custom field values attached to the contact.
Show child attributes
Show child attributes
Where the contact was sourced from.
Source category for the contact.
Whether the contact is unsubscribed from outreach.
