UpWork APIs
Account Request URL
-Base Endpoint
-
Jobs
Retrieve job details. The endpoint returns all jobs that match the filter criteria.
/api/jobs/v2/search
limit, location, categories, company, job_types, freelance_types, job_field, job_view, client_job_ref, sort, client_view, job_visibility, skill, subject, total_pages, is_featured, has_attachments, is_private, can_view_contact_info, max_rate, min_rate, currency, is_hourly
Jobs
Allows users to create a new job. The request must include an XML or JSON document with the appropriate job data.
/api/jobs/v2/post_job
title, description, company_name, is_text_free, application_url, payment_options, job_category, work_location, pay_rate, currency, job_visibility, job_skills, duration, project_type, specific_instructions, is_featured, use_sandbox, is_private, is_html_view, job_application_data, client_job_ref, can_view_contact_info, close_time, enable_submit_bid, is_one_time_job
Jobs
Allows users to update a job.
/api/jobs/v2/~job_ref_id~
-
Jobs
Allows users to patch a job.
/api/jobs/v2/~job_ref_id~
client_id, title, description, company_name, is_text_free, application_url, payment_options, job_category, work_location, pay_rate, currency, job_visibility, job_skills, duration, project_type, specific_instructions, is_featured, use_sandbox, is_private, is_html_view, job_application_data, client_job_ref, can_view_contact_info, close_time, enable_submit_bid, is_one_time_job
Jobs
Allows users to delete a job.
/api/jobs/v2/~job_ref_id~
client_id
Proposals
Retrieves a list of proposals associated with a specific job.
/api/proposals/v2/~job_ref_id~/proposals
-
Proposals
Allows users to submit a proposal on a job.
/api/proposals/v2/~job_ref_id~/submit_proposal
proposal
Messages
Retrieves a list of all message threads a specific user is a part of.
/api/hrs/v2/threads
limit, status, category, before, after, page, per_page, read, unread, sent, received, any, starred, job_id
Messages
Allows users to send a message to one or more user(s).
add_job|resend|recipients|subject|body
Messages
Updates the status of an existing message thread.
/api/hrs/v2/threads/~thread_id~
read
Messages
Marks a message thread as deleted.
/api/hrs/v2/threads/~thread_id~
client_id
Users
Retrieve user details.
/api/users/v2/me
-
Users
Create a new user.
/api/users/v2/register
username, first_name, last_name, email, password, mobile, tos, up_to_date, availability, job_success, role
Users
Allows users to update their account information.
/api/users/v2/me
-
Users
Allows users to update their account information.
/api/users/v2/me
first_name, last_name, email, mobile, up_to_date, job_success, security_question, security_answer, new_password
Users
Allows users to delete their account from upwork once their balance is 0.
/api/users/v2/me
-
Timelogs
Retrieves a list of timelog entries.
/api/hrs/v2/time_entries
states, and_states
Timelogs
Allows users to submit timelog entries.
/api/hrs/v2/time_entries
task_id, spent_at, hours, notes, entry_type, entry_date
Timelogs
Allows users to update a timelog entry.
/api/hrs/v2/time_entries/~entry_id~
hours, notes, entry_date
Timelogs
Delete a timelog entry.
/api/hrs/v2/time_entries/~entry_id~
client_id
Payments
Retrieve payment information.
/api/payments/v2/transactions
limit, start_date, end_date, page, per_page, work_diary_id, job_id
Payments
Allows users to submit a request to withdraw money.
/api/payments/v2/withdrawals
amount, currency, account_holder_name, bank_name, account_number, routing_number, address1, address2, city, state, zip, country, ssn
Payments
Allows users to update an existing payment request.
/api/payments/v2/withdrawals/~withdrawal_id~
amount, account_holder_name, bank_name, account_number, routing_number, address1, address2, city, state, zip, country, ssn
Payments
Allows users to cancel an existing payment request.
/api/payments/v2/withdrawals/~withdrawal_id~
client_id
Notifications
Retrieve notifications for a specific user.
/api/notifications/v2/user_notifications
limit, status, start_time
Notifications
Allows users to subscribe to a specific channel.
/api/notifications/v2/subscriptions
channel_id
Notifications
Allows users to unsubscribe from a specific channel.
/api/notifications/v2/subscriptions
channel_id
Earnings
Allows users to retrieve an earnings list.
/api/payments/v2/earnings
earnings_date_range, pay_period, currency, limit, page, sort_direction
Earnings
-
Allows users to fetch earnings transfers.
/api/payments/v2/earnings_transfers
Reports
Retrieve talent report data.
/api/hr/v2/talent_analytics/reports
talent_analytics_date_type, job_owner_id, skill_category, job_type, employment_type, billing_basis, currency, report_type, limit, page
Reports
-
Retrieve client report data.
/api/hr/v2/client_analytics/reports
Files
Allows users to retrieve a file's metadata.
/api/files/v1/~file_id~/properties
client_id
Files
Upload files to Upwork.
/api/files/v1/upload
file_content, file_name
Files
Allows users to overwrite the file contents.
/api/files/v1/~file_id~
file_content
Files
Delete a file.
/api/files/v1/~file_id~
client_id
Details
Provider
Country HQ
API Type
Categories
Alternatives
Important URLs
Last Updated on
Created At
Other Apps
Upskill for a better future
Want to start tracking API at scale?
Get updates about your favorite APIs and SDKs
We do our best to ensure that the data we release is complete, accurate, and useful. However, because we are not able to verify all the data, and because the processing required to make the data useful is complex, we cannot be held liable for omissions or inaccuracies.
