# 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.

## Servers
- Production server: https://api.1099policy.com (Production server)

## Parameters

### Query parameters

- **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.

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

#### Body: application/json (array[object])
- **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](https://dashboard.1099policy.com/jobs).

- **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.

[Powered by Bump.sh](https://bump.sh)