curl --location --request GET 'https://api.hirempire.com/v1/job-sources?job_id={job_id}' \
--header 'Authorization: Bearer sk-••••••••••••'
{
"success": true,
"job_id": "8fc4ea3c-ecc4-4a92-96fd-a14436a79a1b",
"total_sources": 2,
"sources": [
{
"id": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
"source_name": "LinkedIn",
"source_url": "https://jobs.hirempire.com/acme/1a2b3c4d-5e6f-7890-abcd-ef1234567890",
"code": "a3f9",
"visits": 142,
"created_at": "2026-06-18T10:00:00.000Z"
},
{
"id": "9z8y7x6w-5v4u-3210-fedc-ba0987654321",
"source_name": "Referral",
"source_url": "https://jobs.hirempire.com/acme/9z8y7x6w-5v4u-3210-fedc-ba0987654321",
"code": "b7c1",
"visits": 36,
"created_at": "2026-06-19T08:14:00.000Z"
}
]
}
Jobs
Get job sources
List the tracked source URLs configured for a specific job
GET
/
v1
/
job-sources
curl --location --request GET 'https://api.hirempire.com/v1/job-sources?job_id={job_id}' \
--header 'Authorization: Bearer sk-••••••••••••'
{
"success": true,
"job_id": "8fc4ea3c-ecc4-4a92-96fd-a14436a79a1b",
"total_sources": 2,
"sources": [
{
"id": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
"source_name": "LinkedIn",
"source_url": "https://jobs.hirempire.com/acme/1a2b3c4d-5e6f-7890-abcd-ef1234567890",
"code": "a3f9",
"visits": 142,
"created_at": "2026-06-18T10:00:00.000Z"
},
{
"id": "9z8y7x6w-5v4u-3210-fedc-ba0987654321",
"source_name": "Referral",
"source_url": "https://jobs.hirempire.com/acme/9z8y7x6w-5v4u-3210-fedc-ba0987654321",
"code": "b7c1",
"visits": 36,
"created_at": "2026-06-19T08:14:00.000Z"
}
]
}
Query Parameters
The job UUID to fetch sources for.
Authentication
Bearer authentication header of the form
Bearer <token>.curl --location --request GET 'https://api.hirempire.com/v1/job-sources?job_id={job_id}' \
--header 'Authorization: Bearer sk-••••••••••••'
Response
The job UUID.
Array of source link objects.
Show Source object properties
Show Source object properties
UUID of the source link.
Human-readable source label (e.g.
LinkedIn, Indeed, Referral).Publicly shareable URL for this source. Visits to this URL increment the source’s
visits counter.Internal 4-character opaque code (kept for tracking continuity; not used in the public URL anymore).
Number of times the source URL has been opened.
ISO 8601 timestamp when the source link was created.
{
"success": true,
"job_id": "8fc4ea3c-ecc4-4a92-96fd-a14436a79a1b",
"total_sources": 2,
"sources": [
{
"id": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
"source_name": "LinkedIn",
"source_url": "https://jobs.hirempire.com/acme/1a2b3c4d-5e6f-7890-abcd-ef1234567890",
"code": "a3f9",
"visits": 142,
"created_at": "2026-06-18T10:00:00.000Z"
},
{
"id": "9z8y7x6w-5v4u-3210-fedc-ba0987654321",
"source_name": "Referral",
"source_url": "https://jobs.hirempire.com/acme/9z8y7x6w-5v4u-3210-fedc-ba0987654321",
"code": "b7c1",
"visits": 36,
"created_at": "2026-06-19T08:14:00.000Z"
}
]
}
Error Responses
400 Bad Request
{ "success": false, "error": "Query parameter 'job_id' is required." }
401 Unauthorized
{ "success": false, "error": "Invalid token" }
404 Not Found
{ "success": false, "error": "Job not found" }
Was this page helpful?
⌘I