Get Client Jobs

GET

/api/v1/clients/:companyId/jobs

Returns the buyer's open jobs and complete work history, alongside aggregate stats — derived from the freshest scrape we have for that company.

Authentication

This endpoint uses the public Data API key system — a Bearer token, not the x-api-key header used by the auto-apply endpoints.

Authorization: Bearer up_<your-key>

Path parameters

Parameter	Type	Description
`companyId`	stringrequired	Upwork company identifier. You can find this on any of the buyer's archived jobs at `authJobDetailsResponse.data.jobAuthDetails.buyer.info.company.companyId`, or fall back to `jobDetailsResponse.data.jobPubDetails.buyer.company.companyId`.

Example

cURL

curl "https://uphunt.io/api/v1/clients/1991212616395436888/jobs" -H "Authorization: Bearer up_abc123def456..."

Response

{
  "companyId": "1991212616395436888",
  "lastSyncedAt": 1778344861000,
  "buyer": {
    "company":   { "name": "Acme Inc.", "companyId": "1991212616395436888", "isEDCReplicated": null, "contractDate": "2025-11-19T00:00:00.000Z" },
    "location":  { "city": "St..hlingen", "country": "DEU", "countryTimezone": "Europe/Berlin (UTC+02:00)" },
    "stats":     { "totalAssignments": 20, "score": 4.75, "totalCharges": { "amount": 1721.68 }, "feedbackCount": 8, "totalJobsWithHires": 16 },
    "enterprise": false,
    "avgHourlyJobsRate": { "amount": 22.23 },
    "postedCount": 57,
    "topClient": false,
    "phoneVerificationStatus": { "status": "VERIFIED" }
  },
  "openJobs": [
    {
      "id": "2052895097657407455",
      "ciphertext": "~022052895097657407455",
      "title": "LONG-TERM! Only Experienced Video Editor",
      "type": "FIXED",
      "isPtcPrivate": false
    }
  ],
  "workHistory": [
    {
      "isPtcJob": false,
      "status": "ACTIVE",
      "startDate": "2026-03-31T12:23:23.855Z",
      "endDate": null,
      "totalCharge": 235.94,
      "totalHours": 10.33,
      "jobInfo": { "title": "Mighty Networks Architect", "id": "2040846723050472167", "ciphertext": "~022040846723050472167" },
      "contractorInfo": { "contractorName": "Angelia A I.", "ciphertext": "~01cd73bd718fc7f708" },
      "rate": { "amount": 22.22 },
      "feedback": null,
      "feedbackToClient": null
    }
  ],
  "archivedCiphers": ["~022040846723050472167"],
  "archivedJobIds": ["2040846723050472167"]
}

Field notes

Parameter	Type	Description
`lastSyncedAt`	number	Unix milliseconds. The `openJobs` list and buyer stats reflect this moment, not real time.
`buyer`	object	Buyer-level fields. Some entries (`enterprise`, `phoneVerificationStatus`, `avgHourlyJobsRate`) require auth-enriched scrape data and may be `null` when only the public payload is available.
`openJobs`	array	Currently posted jobs from this buyer at `lastSyncedAt`. Each entry can be opened via Get Job by Ciphertext for the full payload.
`workHistory`	array	Past contracts (active and closed). Includes contractor name, dates, total charge, hourly rate, and freelancer/buyer feedback when not suppressed. Private contracts may arrive with `jobInfo.ciphertext: null` but still expose `jobInfo.id`.
`archivedCiphers`	string[]	Subset of ciphertexts mentioned in `openJobs` + `workHistory` that we already hold in our archive. Use these to mark rows you can fetch via Get Job by Ciphertext.
`archivedJobIds`	string[]	Subset of `workHistory[].jobInfo.id` values that we already hold. Useful for private past contracts where no ciphertext is exposed.

Errors

Status	Code	When
401	`unauthorized`	API key missing, invalid, or revoked
404	`not_found`	No archived jobs match the `companyId`
429	`rate_limit_exceeded`	Monthly quota consumed

Get Job — full details for a single job.
Rate Limits — 10,000 requests per billing period.