operation get api v1 jobs.md

List all jobs

GET /api/v1/jobs

Returns a list of your jobs. The jobs are returned sorted by creation date, with the most recently created jobs appearing first.

limit (integer)
A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
starting_after (string)
A cursor for use in pagination. starting_after is an job ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with jb_fOo123, your subsequent call can include starting_after=jb_fOo123 in order to fetch the next page of the list.
ending_before (string)
A cursor for use in pagination. ending_before is an job ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with jb_bAr123, your subsequent call can include ending_before=jb_bAr123 in order to fetch the previous page of the list.

Returns an array of job objects. If no more jobs are available, the resulting array will be empty.

address (object)
category_code (string)
The category code that 1099Policy creates for a group of similarly classified jobs.

Job category codes are pre-approved by 1099Policy so you can offer contractors insurance to new jobs on your platform in real time.

To generate pre-approved category codes for a group of similarly classified jobs visit the 1099Policy Dashboard.

created (integer(int64))
custom_metadata (object)
Set of key-value pairs that you can attach to the job object. Used for storing additional information in a structured format. Individual keys can be unset by posting an empty value to them. Pass an empty value, e.g., {}, to custom_metadata to unset all keys.
The purchase_order_number key is recognized: invoices created for this job inherit it as their purchase order number (overridable or clearable per invoice via the invoice endpoints).
description (string)
A description of the job that includes the role, responsibilities and necessary qualifications.
entity (string)
The entity ID for whom the work is being done.
id (string)
name (string)
The name of the contractor job role.
wage (integer)
A positive integer representing the total wage (e.g., 1500 cents is $15.00). The minimum wage amount is 100 cents US. The maximum wage amount is 100000000 cents US ($1,000,000).
wage_type ()
One of flatfee, hourly, unit or blended.
years_experience (integer)
The number of years of experience required to be eligible for the job.