Create a job | 1099Policy API documentation

Create a job

API

POST /api/v1/jobs

Creates a new job object. Used to classify the work that 1099Policy applies to insure the contractor.

application/json

Body

• address
  object
  The job address where the work will be done. Exclude if job will be done remotely.

• 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 Required
    2-letter state code.

• category_code
  string Required
  The category code that 1099Policy creates for a group of similarly classified jobs.

• custom_metadata
  object
  Set of key-value pairs that you can attach to an object. Used to store additional information about the job in a structured format.

• description
  string Required
  A description of the job that includes the role, responsibilities and necessary qualifications.

• entity
  string Required
  The ID of an existing entity for whom the job is being done.

• name
  string Required
  The name of the contractor job role.

• wage
  integer Required
  A positive integer representing the wage (e.g., 1500 cents is $15.00). The minimum wage amount is $1.00 US.

• wage_type
  string Required
  One of flatfee, hourly, unit or blended.

• withhold_premium
  boolean
  This indicates whether the contractor is paying premium directly with their credit card.

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

Responses

• 201
  application/json
  Returns the job object if the post succeeded.

• address
  object
  The job address where the work will be done. Exclude if job will be done remotely.

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

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

• 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
  Unique identifier for the object.

• name
  string
  The name of the contractor job role.

• wage
  integer
  A positive integer representing the total wage.

• wage_type
  string
  One of flatfee, hourly, unit or blended.

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

Example cURL Request

curl \
 --request POST 'https://api.1099policy.com/api/v1/jobs' \
 --header "Content-Type: application/json" \
 --data '{"address":{"country":"null","line1":"92 Geary St","line2":"null","locality":"San Francisco","postalcode":94114,"region":"CA"},"category_code":"string","custom_metadata":{},"description":"string","entity":"string","name":"string","wage":42,"wage_type":"flatfee","withhold_premium":true,"years_experience":42}'

Example Response

{
  "address": {
    "country": "null",
    "line1": "92 Geary St",
    "line2": "null",
    "locality": "San Francisco",
    "postalcode": 94114,
    "region": "CA"
  },
  "category_code": "string",
  "custom_metadata": {},
  "description": "string",
  "entity": "string",
  "name": "string",
  "wage": 42,
  "wage_type": "flatfee",
  "withhold_premium": true,
  "years_experience": 42
}