Retrieve a job

GET /api/v1/jobs/{job_id}

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.

Path parameters

  • job string Required

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

Responses

  • 200 application/json

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

    Hide response attributes Show response attributes object
    • address object
      Hide address attributes Show address attributes object
      • country string | null

        2-letter country code.

      • line1 string

        Address line 1 (Street address/PO Box).

      • line2 string | null

        Address line 2 (Apartment/Suite/Unit/Building).

      • locality string

        City/District/Suburb/Town/Village.

      • ZIP or postal code.

      • region string

        2-letter state code.

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

      Time at which the object was created. Measured in seconds since the Unix epoch.

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

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

      Minimum value is 100, maximum value is 100000000.

    • One of flatfee, hourly, unit or blended.

      Values are flatfee, hourly, unit, or blended.

    • The number of years of experience required to be eligible for the job.

GET /api/v1/jobs/{job_id}
curl \
 -X GET https://api.1099policy.com/api/v1/jobs/{job_id}
Response examples (200)
{
  "address": {
    "country": "null",
    "line1": "92 Geary St",
    "line2": "null",
    "locality": "San Francisco",
    "postalcode": 94114,
    "region": "CA"
  },
  "category_code": "jc_MTqpkbkp6G",
  "created": 1646818364,
  "custom_metadata": {
    "campaign": "Red Bull"
  },
  "description": "Install fiber optic cable from back to the front of the store.",
  "entity": "en_Ah3tqYn",
  "id": "jb_jsb9KEcTpc",
  "name": "Field technician",
  "wage": 15000,
  "wage_type": "flatfee",
  "years_experience": 10
}