Get contact
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>",
"customFieldDefinitionId": "<string>",
"valueType": "freeText",
"value": "<string>"
}
],
"source": "<string>",
"sourceType": "<string>",
"unsubscribed": true
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"statusCode": 429,
"error": "Too Many Requests",
"message": "<string>",
"retryAfterSeconds": 123
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}Contacts
Get contact
View a contact’s profile, contact details, and sequence information.
GET
/
contacts
/
{contactId}
Get contact
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>",
"customFieldDefinitionId": "<string>",
"valueType": "freeText",
"value": "<string>"
}
],
"source": "<string>",
"sourceType": "<string>",
"unsubscribed": true
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"statusCode": 429,
"error": "Too Many Requests",
"message": "<string>",
"retryAfterSeconds": 123
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}Use the
contactId returned by a contact search or import to review that person’s record.
Custom field entries include their assignment _id, current fieldName and customFieldDefinitionId when linked to a workspace definition. An assignment is marked legacy in the app when its reusable definition cannot be resolved. It may still have a stored name and value, but it cannot be used with definition-based filters.
In the app, “awaiting values” counts assignments with no value; it is not a background job. It decreases when you fill or remove an empty assignment.
Rate limit: 120 requests/minute per endpoint and workgroup. Details.Authorizations
Response
Contact
Integration-friendly contact representation used by the public OpenAPI surface.
