Retrieve a job

GET /api/v1/jobs/{job}

Retrieves the details of an existing job. Supply the unique job ID from either a job creation request or the job list, and 1099Policy will return the corresponding job information.

Servers

• Production server: https://api.1099policy.com (Production server)

Parameters

Path parameters

• job (string)
  The ID of the desired job (e.g., jb_jsb9KEcTpc).

Responses

200

Returns a job object if a valid job ID was provided. Returns an error otherwise.

Body: application/json (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.

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