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.

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.

    Minimum value is 1, maximum value is 100. Default value 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 application/json

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

    Hide response attributes Show response attributes object
    • address object
      Hide address attributes Show address attributes
      • 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.

      • postalcode string

        ZIP or postal code.

      • region string

        2-letter state code.

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

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

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

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

      Minimum value is 100, maximum value is 100000000.

    • wage_type

      One of flatfee, hourly, unit or blended.

      Values are flatfee, hourly, unit, or blended.

    • years_experience integer

      The number of years of experience required to be eligible for the job.
GET /api/v1/jobs 
curl \
 -X GET https://api.1099policy.com/api/v1/jobs
Response examples (200) 
[
  {
    "category_code": "jc_MTqpkbkp6G",
    "created": 1646818364,
    "custom_metadata": {
      "campaign": "Volvo"
    },
    "description": "BMW engine diagnostics and troubleshooting.",
    "entity": "en_C9Z2DmfHSF",
    "id": "jb_jsb9KEcTpc",
    "name": "Mechanic technician",
    "wage": 1500,
    "wage_type": "flatfee",
    "years_experience": 5
  }
]