1099Policy API Reference

API Reference

The 1099Policy API is based on REST principles with resource-oriented URLs that accept JSON request bodies and return JSON responses. Use the 1099Policy API and the keys available on your 1099Policy Dashboard to offer contractors on your platform access to on-demand, pay-as-you-go insurance.

Use the development environment secret key to step through the process of procuring insurance using 1099Policy API for test contractors and job assignments. Because the API key you use to authenticate determines whether the request runs in our production environment or in our development environment, going live on the 1099Policy platform is as easy as replacing the development secret key with the production secret key once you're ready.

Authentication

To use the 1099Policy API you need to authenticate requests using API keys. Sign up for a developer account to view and manage your API keys from the the 1099Policy Dashboard. https://dashboard.1099policy.com/register

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Environments

Test mode secret keys have the prefix t9k_test_ and live mode secret keys have the prefix t9k_live_.

Securing Keys

Your API tokens should be guarded closely. As a reminder, do not share your secret API keys in publicly accessible areas such as GitHub or client-side code, for example. Instead use environment variables, web server settings, startup script, or a configuration file that is excluded from your version control.

Errors

1099Policy uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the 2xx range indicate success. Codes in the 4xx range indicate an error due to the the information provided (e.g., a required parameter was omitted, a create policy request failed, etc.). Codes in the 5xx range indicate an error with 1099Policy's servers (these are rare).

Some 4xx errors that could be handled programmatically (e.g., contractor inelgible for coverage) include an error code that briefly explains the error reported.

Handling Errors

Our API libraries raise exceptions for many reasons, such as a failed create policy request, invalid parameters, authentication errors, and network unavailability. We recommend writing code that gracefully handles all possible API exceptions.

Idempotent Requests

The 1099Policy API checks every request body for an an additional idempotency_key. We use this field to perform an idempotency check to avoid duplicate transfers in case of network failures or timeouts. For example, if a request to bind a policy fails to return a response due to a network connection error, you can retry the request with the same idempotency key to guarantee that no more than one policy is created.

1099Policy's idempotency works by saving the resulting status code and body of the first request made for any given idempotency key, regardless of whether it succeeded or failed. Subsequent requests with the same key return the same result, including 500 errors.

We suggest using V4 UUIDs, or another random string with enough entropy to avoid collisions.

Keys expire after 24 hours, so a new request is generated if a key is reused outside of that time frame. Results are only saved if an API endpoint started executing. You can safely retry requests that fail validation or conflicts with another request that was executing concurrently.

All POST requests accept idempotency keys. Sending idempotency keys in GET and DELETE requests has no effect and should be avoided, as these requests are idempotent by definition.

This is the documentation for version 1.5.3 of the API. Last update on May 23, 2021.

Base URL
//api.1099policy.com

Contractor

A Contractor object represents the contractor that can accept one or more jobs on your platform. The API allows you to create, delete, and update contractors. You can retrieve individual contractors as well as a list
of all contractors.

List all contractors

Returns a list of your contractors. The contractors are
returned sorted by creation date, with the most recent
contractors appearing first.

Body
  • limit integer

    A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.

Responses
  • 200 array[object]

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

    • address object
      • country string

        2-letter country code.

      • line1 string

        Address line 1 (Street address/PO Box/Company name).

      • line2 string

        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.

    • company_name string

      The contractor's business name.

    • created integer(int64)
    • first_name string

      The contractor's first name.

    • id string

      Unique identifier for the object.

    • last_name string

      The contractor's last name.

    • phone string

      The contractor's phone number.

GET /api/v1/contractors
$ curl \
 -X GET //api.1099policy.com/api/v1/contractors \
 -H "Content-Type: application/json" \
 -d '{"limit":42}'
Request example
{
  "limit": 42
}
Response example (200)
[
  {
    "address": [
      {
        "country": "string",
        "line1": "string",
        "line2": "string",
        "locality": "string",
        "postalcode": "string",
        "region": "string"
      }
    ],
    "company_name": "string",
    "created": 42,
    "first_name": "string",
    "id": "string",
    "last_name": "string",
    "phone": "string"
  }
]

Create a contractor

Creates a new contractor object.

Body
  • address object
    • country string

      2-letter country code.

    • line1 string

      Address line 1 (Street address/PO Box/Company name).

    • line2 string

      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.

  • company_name string

    The contractor's business name.

  • created integer(int64)
  • first_name string

    The contractor's first name.

  • id string

    Unique identifier for the object.

  • last_name string

    The contractor's last name.

  • phone string

    The contractor's phone number.

Responses
  • 200 object

    The posted request body

    • address object
      • country string

        2-letter country code.

      • line1 string

        Address line 1 (Street address/PO Box/Company name).

      • line2 string

        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.

    • company_name string

      The contractor's business name.

    • created integer(int64)
    • first_name string

      The contractor's first name.

    • id string

      Unique identifier for the object.

    • last_name string

      The contractor's last name.

    • phone string

      The contractor's phone number.

POST /api/v1/contractors
$ curl \
 -X POST //api.1099policy.com/api/v1/contractors \
 -H "Content-Type: application/json" \
 -d '{"address":{"country":"string","line1":"string","line2":"string","locality":"string","postalcode":"string","region":"string"},"company_name":"string","created":42,"first_name":"string","id":"string","last_name":"string","phone":"string"}'
Request example
{
  "address": {
    "country": "string",
    "line1": "string",
    "line2": "string",
    "locality": "string",
    "postalcode": "string",
    "region": "string"
  },
  "company_name": "string",
  "created": 42,
  "first_name": "string",
  "id": "string",
  "last_name": "string",
  "phone": "string"
}
Response example (200)
{
  "address": {
    "country": "string",
    "line1": "string",
    "line2": "string",
    "locality": "string",
    "postalcode": "string",
    "region": "string"
  },
  "company_name": "string",
  "created": 42,
  "first_name": "string",
  "id": "string",
  "last_name": "string",
  "phone": "string"
}

Retrieve a contractor

Retrieves the details of an existing contractor.
You need only supply the unique contractor identifier
that was returned upon contractor creation.

Body
  • contractor string

    The identifier of the contractor to be retrieved.

Responses
  • 200 object

    Returns a contractor object if a valid identifier was provided.

    • address object
      • country string

        2-letter country code.

      • line1 string

        Address line 1 (Street address/PO Box/Company name).

      • line2 string

        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.

    • company_name string

      The contractor's business name.

    • created integer(int64)
    • first_name string

      The contractor's first name.

    • id string

      Unique identifier for the object.

    • last_name string

      The contractor's last name.

    • phone string

      The contractor's phone number.

GET /api/v1/contractors/{contractor_id}
$ curl \
 -X GET //api.1099policy.com/api/v1/contractors/{contractor_id} \
 -H "Content-Type: application/json" \
 -d '{"contractor":"string"}'
Request example
{
  "contractor": "string"
}
Response example (200)
{
  "address": {
    "country": "string",
    "line1": "string",
    "line2": "string",
    "locality": "string",
    "postalcode": "string",
    "region": "string"
  },
  "company_name": "string",
  "created": 42,
  "first_name": "string",
  "id": "string",
  "last_name": "string",
  "phone": "string"
}

Update a contractor

Updates the specified contractor by setting the values
of the parameters passed. Any parameters not provided
will be left unchanged.

This request accepts mostly the same arguments as the
contractor creation call.

Body
  • address object
    • country string

      2-letter country code.

    • line1 string

      Address line 1 (Street address/PO Box/Company name).

    • line2 string

      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.

  • company_name string

    The contractor's business name.

  • created integer(int64)
  • first_name string

    The contractor's first name.

  • id string

    Unique identifier for the object.

  • last_name string

    The contractor's last name.

  • phone string

    The contractor's phone number.

Responses
  • 200 object

    Returns the contractor object if the update succeeded. Returns an error if update parameters are invalid.

    • address object
      • country string

        2-letter country code.

      • line1 string

        Address line 1 (Street address/PO Box/Company name).

      • line2 string

        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.

    • company_name string

      The contractor's business name.

    • created integer(int64)
    • first_name string

      The contractor's first name.

    • id string

      Unique identifier for the object.

    • last_name string

      The contractor's last name.

    • phone string

      The contractor's phone number.

PUT /api/v1/contractors/{contractor_id}
$ curl \
 -X PUT //api.1099policy.com/api/v1/contractors/{contractor_id} \
 -H "Content-Type: application/json" \
 -d '{"address":{"country":"string","line1":"string","line2":"string","locality":"string","postalcode":"string","region":"string"},"company_name":"string","created":42,"first_name":"string","id":"string","last_name":"string","phone":"string"}'
Request example
{
  "address": {
    "country": "string",
    "line1": "string",
    "line2": "string",
    "locality": "string",
    "postalcode": "string",
    "region": "string"
  },
  "company_name": "string",
  "created": 42,
  "first_name": "string",
  "id": "string",
  "last_name": "string",
  "phone": "string"
}
Response example (200)
{
  "address": {
    "country": "string",
    "line1": "string",
    "line2": "string",
    "locality": "string",
    "postalcode": "string",
    "region": "string"
  },
  "company_name": "string",
  "created": 42,
  "first_name": "string",
  "id": "string",
  "last_name": "string",
  "phone": "string"
}

Delete a contractor

Permanently deletes a contractor. It cannot be undone.
Also immediately cancels any active policies connected
with the contractor.

Body
  • contractor string

    The ID of the contractor to be deleted.

Responses
  • 200 object

    Returns an object with a deleted parameter on success. If the contractor ID does not exist, this call returns an error.

    • deleted boolean
    • id string

      The contractor ID.

    • object string

      Default value is contractor.

DELETE /api/v1/contractors/{contractor_id}
$ curl \
 -X DELETE //api.1099policy.com/api/v1/contractors/{contractor_id} \
 -H "Content-Type: application/json" \
 -d '{"contractor":"string"}'
Request example
{
  "contractor": "string"
}
Response example (200)
{
  "deleted": true,
  "id": "string",
  "object": "string"
}

Entity

The Entity object represents the contracting entity responsible for defining the job descriptions and for hiring contractors.

The API allows you to create, delete, and update entities. You can retrieve individual entities as well as a list of all entities.

List all entities

Returns a list of your contracting entities. The entities
are returned sorted by creation date, with the most recent
entities appearing first.

Body
  • limit integer

    A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.

Responses
  • 200 array[object]

    Returns an array of entity objects. If no more entities are available, the resulting array will be empty. Returns an error if the entity ID is invalid.

    • address object
      • country string

        2-letter country code.

      • line1 string

        Address line 1 (Street address/PO Box/Company name).

      • line2 string

        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.

    • coverage_lmiit object
      • aggregate_limit integer

        The total amount the insurance company will pay for multiple claims over the course of one policy term.

      • id string

        Unique identifier for the object.

      • occurrence_limit integer

        The total amount the insurance company will pay per incident during the policy term.

    • created integer(int64)
    • id string

      Unique identifier for the object.

    • name string

      The contracting entity's legal name.

    • required_coverage object

      The types of insurance coverage available on the 1099Policy platform.

      • coverage_type

        Either general, professional or workers-comp.

        Values are general, professional, and workers-comp.

      • id string

        Unique identifier for the object.

GET /api/v1/entities
$ curl \
 -X GET //api.1099policy.com/api/v1/entities \
 -H "Content-Type: application/json" \
 -d '{"limit":42}'
Request example
{
  "limit": 42
}
Response example (200)
[
  {
    "address": [
      {
        "country": "string",
        "line1": "string",
        "line2": "string",
        "locality": "string",
        "postalcode": "string",
        "region": "string"
      }
    ],
    "coverage_lmiit": [
      {
        "aggregate_limit": 42,
        "id": "string",
        "occurrence_limit": 42
      }
    ],
    "created": 42,
    "id": "string",
    "name": "string",
    "required_coverage": [
      {
        "coverage_type": "string",
        "id": "string"
      }
    ]
  }
]

Create an entity

Creates a new contracting entity object.

Body
  • address object
    • country string

      2-letter country code.

    • line1 string

      Address line 1 (Street address/PO Box/Company name).

    • line2 string

      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.

  • coverage_lmiit object
    • aggregate_limit integer

      The total amount the insurance company will pay for multiple claims over the course of one policy term.

    • id string

      Unique identifier for the object.

    • occurrence_limit integer

      The total amount the insurance company will pay per incident during the policy term.

  • created integer(int64)
  • id string

    Unique identifier for the object.

  • name string

    The contracting entity's legal name.

  • required_coverage object

    The types of insurance coverage available on the 1099Policy platform.

    • coverage_type

      Either general, professional or workers-comp.

      Values are general, professional, and workers-comp.

    • id string

      Unique identifier for the object.

Responses
  • 200 object

    The posted request body

    • address object
      • country string

        2-letter country code.

      • line1 string

        Address line 1 (Street address/PO Box/Company name).

      • line2 string

        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.

    • coverage_lmiit object
      • aggregate_limit integer

        The total amount the insurance company will pay for multiple claims over the course of one policy term.

      • id string

        Unique identifier for the object.

      • occurrence_limit integer

        The total amount the insurance company will pay per incident during the policy term.

    • created integer(int64)
    • id string

      Unique identifier for the object.

    • name string

      The contracting entity's legal name.

    • required_coverage object

      The types of insurance coverage available on the 1099Policy platform.

      • coverage_type

        Either general, professional or workers-comp.

        Values are general, professional, and workers-comp.

      • id string

        Unique identifier for the object.

POST /api/v1/entities
$ curl \
 -X POST //api.1099policy.com/api/v1/entities \
 -H "Content-Type: application/json" \
 -d '{"address":{"country":"string","line1":"string","line2":"string","locality":"string","postalcode":"string","region":"string"},"coverage_lmiit":{"aggregate_limit":42,"id":"string","occurrence_limit":42},"created":42,"id":"string","name":"string","required_coverage":{"coverage_type":"general","id":"string"}}'
Request example
{
  "address": {
    "country": "string",
    "line1": "string",
    "line2": "string",
    "locality": "string",
    "postalcode": "string",
    "region": "string"
  },
  "coverage_lmiit": {
    "aggregate_limit": 42,
    "id": "string",
    "occurrence_limit": 42
  },
  "created": 42,
  "id": "string",
  "name": "string",
  "required_coverage": {
    "coverage_type": "string",
    "id": "string"
  }
}
Response example (200)
{
  "address": {
    "country": "string",
    "line1": "string",
    "line2": "string",
    "locality": "string",
    "postalcode": "string",
    "region": "string"
  },
  "coverage_lmiit": {
    "aggregate_limit": 42,
    "id": "string",
    "occurrence_limit": 42
  },
  "created": 42,
  "id": "string",
  "name": "string",
  "required_coverage": {
    "coverage_type": "string",
    "id": "string"
  }
}

Retrieve an entity

Retrieves the details of an existing entity.
You need only supply the unique entity ID
that was returned upon entity creation.

Body
  • entity string

    The ID of the desired entity.

Responses
  • 200 object

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

    • address object
      • country string

        2-letter country code.

      • line1 string

        Address line 1 (Street address/PO Box/Company name).

      • line2 string

        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.

    • coverage_lmiit object
      • aggregate_limit integer

        The total amount the insurance company will pay for multiple claims over the course of one policy term.

      • id string

        Unique identifier for the object.

      • occurrence_limit integer

        The total amount the insurance company will pay per incident during the policy term.

    • created integer(int64)
    • id string

      Unique identifier for the object.

    • name string

      The contracting entity's legal name.

    • required_coverage object

      The types of insurance coverage available on the 1099Policy platform.

      • coverage_type

        Either general, professional or workers-comp.

        Values are general, professional, and workers-comp.

      • id string

        Unique identifier for the object.

GET /api/v1/entities/{entity_id}
$ curl \
 -X GET //api.1099policy.com/api/v1/entities/{entity_id} \
 -H "Content-Type: application/json" \
 -d '{"entity":"string"}'
Request example
{
  "entity": "string"
}
Response example (200)
{
  "address": {
    "country": "string",
    "line1": "string",
    "line2": "string",
    "locality": "string",
    "postalcode": "string",
    "region": "string"
  },
  "coverage_lmiit": {
    "aggregate_limit": 42,
    "id": "string",
    "occurrence_limit": 42
  },
  "created": 42,
  "id": "string",
  "name": "string",
  "required_coverage": {
    "coverage_type": "string",
    "id": "string"
  }
}

Update an entity

Updates the specified entity by setting the values
of the parameters passed. Any parameters not provided
will be left unchanged.

This request accepts mostly the same arguments as the
eneity creation call.

Body
  • address object
    • country string

      2-letter country code.

    • line1 string

      Address line 1 (Street address/PO Box/Company name).

    • line2 string

      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.

  • coverage_lmiit object
    • aggregate_limit integer

      The total amount the insurance company will pay for multiple claims over the course of one policy term.

    • id string

      Unique identifier for the object.

    • occurrence_limit integer

      The total amount the insurance company will pay per incident during the policy term.

  • created integer(int64)
  • id string

    Unique identifier for the object.

  • name string

    The contracting entity's legal name.

  • required_coverage object

    The types of insurance coverage available on the 1099Policy platform.

    • coverage_type

      Either general, professional or workers-comp.

      Values are general, professional, and workers-comp.

    • id string

      Unique identifier for the object.

Responses
  • 200 object

    Returns the entity object if the update succeeded. Returns an error if update parameters are invalid.

    • address object
      • country string

        2-letter country code.

      • line1 string

        Address line 1 (Street address/PO Box/Company name).

      • line2 string

        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.

    • coverage_lmiit object
      • aggregate_limit integer

        The total amount the insurance company will pay for multiple claims over the course of one policy term.

      • id string

        Unique identifier for the object.

      • occurrence_limit integer

        The total amount the insurance company will pay per incident during the policy term.

    • created integer(int64)
    • id string

      Unique identifier for the object.

    • name string

      The contracting entity's legal name.

    • required_coverage object

      The types of insurance coverage available on the 1099Policy platform.

      • coverage_type

        Either general, professional or workers-comp.

        Values are general, professional, and workers-comp.

      • id string

        Unique identifier for the object.

PUT /api/v1/entities/{entity_id}
$ curl \
 -X PUT //api.1099policy.com/api/v1/entities/{entity_id} \
 -H "Content-Type: application/json" \
 -d '{"address":{"country":"string","line1":"string","line2":"string","locality":"string","postalcode":"string","region":"string"},"coverage_lmiit":{"aggregate_limit":42,"id":"string","occurrence_limit":42},"created":42,"id":"string","name":"string","required_coverage":{"coverage_type":"general","id":"string"}}'
Request example
{
  "address": {
    "country": "string",
    "line1": "string",
    "line2": "string",
    "locality": "string",
    "postalcode": "string",
    "region": "string"
  },
  "coverage_lmiit": {
    "aggregate_limit": 42,
    "id": "string",
    "occurrence_limit": 42
  },
  "created": 42,
  "id": "string",
  "name": "string",
  "required_coverage": {
    "coverage_type": "string",
    "id": "string"
  }
}
Response example (200)
{
  "address": {
    "country": "string",
    "line1": "string",
    "line2": "string",
    "locality": "string",
    "postalcode": "string",
    "region": "string"
  },
  "coverage_lmiit": {
    "aggregate_limit": 42,
    "id": "string",
    "occurrence_limit": 42
  },
  "created": 42,
  "id": "string",
  "name": "string",
  "required_coverage": {
    "coverage_type": "string",
    "id": "string"
  }
}

Delete an entity

Permanently deletes an entity. It cannot be undone.
Also immediately cancels any insurance policies
connected with active jobs managed by the entity.

Body
  • entity string

    The ID of the desired entity.

Responses
  • 200 object

    A successfully deleted entity. Otherwise, this call returns an error, such as if the entity has already been deleted.

    • deleted boolean
    • id string

      The entity ID.

    • object string

      Default value is entity.

DELETE /api/v1/entities/{entity_id}
$ curl \
 -X DELETE //api.1099policy.com/api/v1/entities/{entity_id} \
 -H "Content-Type: application/json" \
 -d '{"entity":"string"}'
Request example
{
  "entity": "string"
}
Response example (200)
{
  "deleted": true,
  "id": "string",
  "object": "string"
}

Job

Store representations of the jobs on your platform in Job objects. The Job is used to, among other things, ensure that the insurance coverage that the 1099Policy platform issues correctly maps to the work that contractors will do.

List all jobs

Returns a list of your jobs. The jobs are returned
sorted by creation date, with the most recently created
jobs appearing first.

Body
  • limit integer

    A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.

Responses
  • 200 array[object]

    Returns an array of job objects. If no more jobs are available, the resulting array will be empty. Returns an error if the job ID is invalid.

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

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

    • entity object

      The Entity object represents the contracting entity responsible for defining the job descriptions and for hiring contractors.
      The API allows you to create, delete, and update entities. You can retrieve individual entities as well as a list of all entities.

      • address object
        • country string

          2-letter country code.

        • line1 string

          Address line 1 (Street address/PO Box/Company name).

        • line2 string

          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.

      • coverage_lmiit object
        • aggregate_limit integer

          The total amount the insurance company will pay for multiple claims over the course of one policy term.

        • id string

          Unique identifier for the object.

        • occurrence_limit integer

          The total amount the insurance company will pay per incident during the policy term.

      • created integer(int64)
      • id string

        Unique identifier for the object.

      • name string

        The contracting entity's legal name.

      • required_coverage object

        The types of insurance coverage available on the 1099Policy platform.

        • coverage_type

          Either general, professional or workers-comp.

          Values are general, professional, and workers-comp.

        • id string

          Unique identifier for the object.

    • id string

      Unique identifier for the object.

    • name string

      The name of the contractor job role.

    • review_status

      One of pending or reviewed.
      Every new job posting is reviewed by a 1099Policy broker and classified to correctly place insurance with our carrier partners.

      Values are pending and reviewed.

    • wage integer

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

      Minimum value is 100.

    • years_experience integer

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

GET /api/v1/jobs
$ curl \
 -X GET //api.1099policy.com/api/v1/jobs \
 -H "Content-Type: application/json" \
 -d '{"limit":42}'
Request example
{
  "limit": 42
}
Response example (200)
[
  {
    "category_code": "string",
    "created": 42,
    "description": "string",
    "entity": [
      {
        "address": [
          {
            "country": "string",
            "line1": "string",
            "line2": "string",
            "locality": "string",
            "postalcode": "string",
            "region": "string"
          }
        ],
        "coverage_lmiit": [
          {
            "aggregate_limit": 42,
            "id": "string",
            "occurrence_limit": 42
          }
        ],
        "created": 42,
        "id": "string",
        "name": "string",
        "required_coverage": [
          {
            "coverage_type": "string",
            "id": "string"
          }
        ]
      }
    ],
    "id": "string",
    "name": "string",
    "review_status": "string",
    "wage": 42,
    "years_experience": 42
  }
]

Create a job

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

Body
  • 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 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)
  • description string

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

  • entity object

    The Entity object represents the contracting entity responsible for defining the job descriptions and for hiring contractors.
    The API allows you to create, delete, and update entities. You can retrieve individual entities as well as a list of all entities.

    • address object
      • country string

        2-letter country code.

      • line1 string

        Address line 1 (Street address/PO Box/Company name).

      • line2 string

        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.

    • coverage_lmiit object
      • aggregate_limit integer

        The total amount the insurance company will pay for multiple claims over the course of one policy term.

      • id string

        Unique identifier for the object.

      • occurrence_limit integer

        The total amount the insurance company will pay per incident during the policy term.

    • created integer(int64)
    • id string

      Unique identifier for the object.

    • name string

      The contracting entity's legal name.

    • required_coverage object

      The types of insurance coverage available on the 1099Policy platform.

      • coverage_type

        Either general, professional or workers-comp.

        Values are general, professional, and workers-comp.

      • id string

        Unique identifier for the object.

  • id string

    Unique identifier for the object.

  • name string

    The name of the contractor job role.

  • review_status

    One of pending or reviewed.
    Every new job posting is reviewed by a 1099Policy broker and classified to correctly place insurance with our carrier partners.

    Values are pending and reviewed.

  • wage integer

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

    Minimum value is 100.

  • years_experience integer

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

Responses
  • 200 object

    The posted request body

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

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

    • entity object

      The Entity object represents the contracting entity responsible for defining the job descriptions and for hiring contractors.
      The API allows you to create, delete, and update entities. You can retrieve individual entities as well as a list of all entities.

      • address object
        • country string

          2-letter country code.

        • line1 string

          Address line 1 (Street address/PO Box/Company name).

        • line2 string

          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.

      • coverage_lmiit object
        • aggregate_limit integer

          The total amount the insurance company will pay for multiple claims over the course of one policy term.

        • id string

          Unique identifier for the object.

        • occurrence_limit integer

          The total amount the insurance company will pay per incident during the policy term.

      • created integer(int64)
      • id string

        Unique identifier for the object.

      • name string

        The contracting entity's legal name.

      • required_coverage object

        The types of insurance coverage available on the 1099Policy platform.

        • coverage_type

          Either general, professional or workers-comp.

          Values are general, professional, and workers-comp.

        • id string

          Unique identifier for the object.

    • id string

      Unique identifier for the object.

    • name string

      The name of the contractor job role.

    • review_status

      One of pending or reviewed.
      Every new job posting is reviewed by a 1099Policy broker and classified to correctly place insurance with our carrier partners.

      Values are pending and reviewed.

    • wage integer

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

      Minimum value is 100.

    • years_experience integer

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

POST /api/v1/jobs
$ curl \
 -X POST //api.1099policy.com/api/v1/jobs \
 -H "Content-Type: application/json" \
 -d '{"category_code":"string","created":42,"description":"string","entity":{"address":{"country":"string","line1":"string","line2":"string","locality":"string","postalcode":"string","region":"string"},"coverage_lmiit":{"aggregate_limit":42,"id":"string","occurrence_limit":42},"created":42,"id":"string","name":"string","required_coverage":{"coverage_type":"general","id":"string"}},"id":"string","name":"string","review_status":"pending","wage":42,"years_experience":42}'
Request example
{
  "category_code": "string",
  "created": 42,
  "description": "string",
  "entity": {
    "address": {
      "country": "string",
      "line1": "string",
      "line2": "string",
      "locality": "string",
      "postalcode": "string",
      "region": "string"
    },
    "coverage_lmiit": {
      "aggregate_limit": 42,
      "id": "string",
      "occurrence_limit": 42
    },
    "created": 42,
    "id": "string",
    "name": "string",
    "required_coverage": {
      "coverage_type": "string",
      "id": "string"
    }
  },
  "id": "string",
  "name": "string",
  "review_status": "string",
  "wage": 42,
  "years_experience": 42
}
Response example (200)
{
  "category_code": "string",
  "created": 42,
  "description": "string",
  "entity": {
    "address": {
      "country": "string",
      "line1": "string",
      "line2": "string",
      "locality": "string",
      "postalcode": "string",
      "region": "string"
    },
    "coverage_lmiit": {
      "aggregate_limit": 42,
      "id": "string",
      "occurrence_limit": 42
    },
    "created": 42,
    "id": "string",
    "name": "string",
    "required_coverage": {
      "coverage_type": "string",
      "id": "string"
    }
  },
  "id": "string",
  "name": "string",
  "review_status": "string",
  "wage": 42,
  "years_experience": 42
}

Retrieve a 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.

Body
  • job string

    The ID of the desired job.

Responses
  • 200 object

    Returns a job object if a valid ID was provided.

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

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

    • entity object

      The Entity object represents the contracting entity responsible for defining the job descriptions and for hiring contractors.
      The API allows you to create, delete, and update entities. You can retrieve individual entities as well as a list of all entities.

      • address object
        • country string

          2-letter country code.

        • line1 string

          Address line 1 (Street address/PO Box/Company name).

        • line2 string

          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.

      • coverage_lmiit object
        • aggregate_limit integer

          The total amount the insurance company will pay for multiple claims over the course of one policy term.

        • id string

          Unique identifier for the object.

        • occurrence_limit integer

          The total amount the insurance company will pay per incident during the policy term.

      • created integer(int64)
      • id string

        Unique identifier for the object.

      • name string

        The contracting entity's legal name.

      • required_coverage object

        The types of insurance coverage available on the 1099Policy platform.

        • coverage_type

          Either general, professional or workers-comp.

          Values are general, professional, and workers-comp.

        • id string

          Unique identifier for the object.

    • id string

      Unique identifier for the object.

    • name string

      The name of the contractor job role.

    • review_status

      One of pending or reviewed.
      Every new job posting is reviewed by a 1099Policy broker and classified to correctly place insurance with our carrier partners.

      Values are pending and reviewed.

    • wage integer

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

      Minimum value is 100.

    • years_experience integer

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

GET /api/v1/jobs/{job_id}
$ curl \
 -X GET //api.1099policy.com/api/v1/jobs/{job_id} \
 -H "Content-Type: application/json" \
 -d '{"job":"string"}'
Request example
{
  "job": "string"
}
Response example (200)
{
  "category_code": "string",
  "created": 42,
  "description": "string",
  "entity": {
    "address": {
      "country": "string",
      "line1": "string",
      "line2": "string",
      "locality": "string",
      "postalcode": "string",
      "region": "string"
    },
    "coverage_lmiit": {
      "aggregate_limit": 42,
      "id": "string",
      "occurrence_limit": 42
    },
    "created": 42,
    "id": "string",
    "name": "string",
    "required_coverage": {
      "coverage_type": "string",
      "id": "string"
    }
  },
  "id": "string",
  "name": "string",
  "review_status": "string",
  "wage": 42,
  "years_experience": 42
}

Update a job

Updates the specific job by setting the values of the
parameters passed. Any parameters not provided will be
left unchanged.

Body
  • 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 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)
  • description string

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

  • entity object

    The Entity object represents the contracting entity responsible for defining the job descriptions and for hiring contractors.
    The API allows you to create, delete, and update entities. You can retrieve individual entities as well as a list of all entities.

    • address object
      • country string

        2-letter country code.

      • line1 string

        Address line 1 (Street address/PO Box/Company name).

      • line2 string

        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.

    • coverage_lmiit object
      • aggregate_limit integer

        The total amount the insurance company will pay for multiple claims over the course of one policy term.

      • id string

        Unique identifier for the object.

      • occurrence_limit integer

        The total amount the insurance company will pay per incident during the policy term.

    • created integer(int64)
    • id string

      Unique identifier for the object.

    • name string

      The contracting entity's legal name.

    • required_coverage object

      The types of insurance coverage available on the 1099Policy platform.

      • coverage_type

        Either general, professional or workers-comp.

        Values are general, professional, and workers-comp.

      • id string

        Unique identifier for the object.

  • id string

    Unique identifier for the object.

  • name string

    The name of the contractor job role.

  • review_status

    One of pending or reviewed.
    Every new job posting is reviewed by a 1099Policy broker and classified to correctly place insurance with our carrier partners.

    Values are pending and reviewed.

  • wage integer

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

    Minimum value is 100.

  • years_experience integer

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

Responses
  • 200 object

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

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

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

    • entity object

      The Entity object represents the contracting entity responsible for defining the job descriptions and for hiring contractors.
      The API allows you to create, delete, and update entities. You can retrieve individual entities as well as a list of all entities.

      • address object
        • country string

          2-letter country code.

        • line1 string

          Address line 1 (Street address/PO Box/Company name).

        • line2 string

          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.

      • coverage_lmiit object
        • aggregate_limit integer

          The total amount the insurance company will pay for multiple claims over the course of one policy term.

        • id string

          Unique identifier for the object.

        • occurrence_limit integer

          The total amount the insurance company will pay per incident during the policy term.

      • created integer(int64)
      • id string

        Unique identifier for the object.

      • name string

        The contracting entity's legal name.

      • required_coverage object

        The types of insurance coverage available on the 1099Policy platform.

        • coverage_type

          Either general, professional or workers-comp.

          Values are general, professional, and workers-comp.

        • id string

          Unique identifier for the object.

    • id string

      Unique identifier for the object.

    • name string

      The name of the contractor job role.

    • review_status

      One of pending or reviewed.
      Every new job posting is reviewed by a 1099Policy broker and classified to correctly place insurance with our carrier partners.

      Values are pending and reviewed.

    • wage integer

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

      Minimum value is 100.

    • years_experience integer

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

PUT /api/v1/jobs/{job_id}
$ curl \
 -X PUT //api.1099policy.com/api/v1/jobs/{job_id} \
 -H "Content-Type: application/json" \
 -d '{"category_code":"string","created":42,"description":"string","entity":{"address":{"country":"string","line1":"string","line2":"string","locality":"string","postalcode":"string","region":"string"},"coverage_lmiit":{"aggregate_limit":42,"id":"string","occurrence_limit":42},"created":42,"id":"string","name":"string","required_coverage":{"coverage_type":"general","id":"string"}},"id":"string","name":"string","review_status":"pending","wage":42,"years_experience":42}'
Request example
{
  "category_code": "string",
  "created": 42,
  "description": "string",
  "entity": {
    "address": {
      "country": "string",
      "line1": "string",
      "line2": "string",
      "locality": "string",
      "postalcode": "string",
      "region": "string"
    },
    "coverage_lmiit": {
      "aggregate_limit": 42,
      "id": "string",
      "occurrence_limit": 42
    },
    "created": 42,
    "id": "string",
    "name": "string",
    "required_coverage": {
      "coverage_type": "string",
      "id": "string"
    }
  },
  "id": "string",
  "name": "string",
  "review_status": "string",
  "wage": 42,
  "years_experience": 42
}
Response example (200)
{
  "category_code": "string",
  "created": 42,
  "description": "string",
  "entity": {
    "address": {
      "country": "string",
      "line1": "string",
      "line2": "string",
      "locality": "string",
      "postalcode": "string",
      "region": "string"
    },
    "coverage_lmiit": {
      "aggregate_limit": 42,
      "id": "string",
      "occurrence_limit": 42
    },
    "created": 42,
    "id": "string",
    "name": "string",
    "required_coverage": {
      "coverage_type": "string",
      "id": "string"
    }
  },
  "id": "string",
  "name": "string",
  "review_status": "string",
  "wage": 42,
  "years_experience": 42
}

Delete a job

Delete a job. Deleting a job is only possible if it
has no insurance policies associated with it.

Body
  • job string

    The ID of the job to delete.

Responses
  • 200 object

    Returns an object with a deleted parameter on success. Otherwise, this call returns an error.

    • deleted boolean
    • id string

      The job ID.

    • object string

      Default value is job.

DELETE /api/v1/jobs/{job_id}
$ curl \
 -X DELETE //api.1099policy.com/api/v1/jobs/{job_id} \
 -H "Content-Type: application/json" \
 -d '{"job":"string"}'
Request example
{
  "job": "string"
}
Response example (200)
{
  "deleted": true,
  "id": "string",
  "object": "string"
}

Policy

To procure contractor insurance, you create a Policy object. You can retrieve individual policies as well as list all policies. Policies are identified by a unique, random ID.

List all policies

Returns a list of policies you’ve previously created.
The policies are returned in sorted order, with the most
recent policies appearing first.

Body
  • limit integer

    A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.

Responses
  • 200 array[object]

    An array of policies, up to limit. Each entry in the array is a separate policy object. If no more charges are available, the resulting array will be empty.

    • created integer(int64)
    • effective_date integer(int64)

      A timestamp used to determine the insurance policy start date.

    • expiration_date integer(int64)

      A timestemp used to determine the insurance policy end date.

    • id string

      Unique identifier for the object.

    • pdf_url string

      A URL for the hosted insurnace policy PDF, which contractors can view.

    • quote object

      The Quote object reflects whether a contractor is eligible for insurance and the premium owed for every $100 earned.

      • contractor object

        A Contractor object represents the contractors that can accept one or more jobs on your platform. The API allows you to create, delete, and update contractors. You can retrieve individual contractors as well as a list of all contractors.

        • address object
          • country string

            2-letter country code.

          • line1 string

            Address line 1 (Street address/PO Box/Company name).

          • line2 string

            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.

        • company_name string

          The contractor's business name.

        • created integer(int64)
        • first_name string

          The contractor's first name.

        • id string

          Unique identifier for the object.

        • last_name string

          The contractor's last name.

        • phone string

          The contractor's phone number.

      • coverage_type object

        The types of insurance coverage available on the 1099Policy platform.

        • coverage_type

          Either general, professional or workers-comp.

          Values are general, professional, and workers-comp.

        • id string

          Unique identifier for the object.

      • created integer(int64)
      • eligible boolean

        Indicates whether a contractor is elgible for insurance or not.

        Default value is true.

      • id string

        Unique identifier for the object.

      • job object

        Store representations of the jobs on your platform in Job objects. The Job is used to, among other things, ensure that the insurance coverage that the 1099Policy platform issues correctly maps to the work that contractors will do.

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

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

        • entity object

          The Entity object represents the contracting entity responsible for defining the job descriptions and for hiring contractors.
          The API allows you to create, delete, and update entities. You can retrieve individual entities as well as a list of all entities.

          • address object
            • country string

              2-letter country code.

            • line1 string

              Address line 1 (Street address/PO Box/Company name).

            • line2 string

              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.

          • coverage_lmiit object
            • aggregate_limit integer

              The total amount the insurance company will pay for multiple claims over the course of one policy term.

            • id string

              Unique identifier for the object.

            • occurrence_limit integer

              The total amount the insurance company will pay per incident during the policy term.

          • created integer(int64)
          • id string

            Unique identifier for the object.

          • name string

            The contracting entity's legal name.

          • required_coverage object

            The types of insurance coverage available on the 1099Policy platform.

            • coverage_type

              Either general, professional or workers-comp.

              Values are general, professional, and workers-comp.

            • id string

              Unique identifier for the object.

        • id string

          Unique identifier for the object.

        • name string

          The name of the contractor job role.

        • review_status

          One of pending or reviewed.
          Every new job posting is reviewed by a 1099Policy broker and classified to correctly place insurance with our carrier partners.

          Values are pending and reviewed.

        • wage integer

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

          Minimum value is 100.

        • years_experience integer

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

      • net_rate integer

        The amount of money the 1099 contractor pays in premium per every $100 earned.
        A positive integer representing the premium owed per $100 earned. The net_rate is stored in cents (e.g., 48 represents $0.48).

        Minimum value is 50.

    • status

      One of active, cancelled, or expired.

      Values are active, cancelled, and expired.

GET /api/v1/policies
$ curl \
 -X GET //api.1099policy.com/api/v1/policies \
 -H "Content-Type: application/json" \
 -d '{"limit":42}'
Request example
{
  "limit": 42
}
Response example (200)
[
  {
    "created": 42,
    "effective_date": 42,
    "expiration_date": 42,
    "id": "string",
    "pdf_url": "string",
    "quote": [
      {
        "contractor": [
          {
            "address": [
              {
                "country": "string",
                "line1": "string",
                "line2": "string",
                "locality": "string",
                "postalcode": "string",
                "region": "string"
              }
            ],
            "company_name": "string",
            "created": 42,
            "first_name": "string",
            "id": "string",
            "last_name": "string",
            "phone": "string"
          }
        ],
        "coverage_type": [
          {
            "coverage_type": "string",
            "id": "string"
          }
        ],
        "created": 42,
        "eligible": true,
        "id": "string",
        "job": [
          {
            "category_code": "string",
            "created": 42,
            "description": "string",
            "entity": [
              {
                "address": [
                  {
                    "country": "string",
                    "line1": "string",
                    "line2": "string",
                    "locality": "string",
                    "postalcode": "string",
                    "region": "string"
                  }
                ],
                "coverage_lmiit": [
                  {
                    "aggregate_limit": 42,
                    "id": "string",
                    "occurrence_limit": 42
                  }
                ],
                "created": 42,
                "id": "string",
                "name": "string",
                "required_coverage": [
                  {
                    "coverage_type": "string",
                    "id": "string"
                  }
                ]
              }
            ],
            "id": "string",
            "name": "string",
            "review_status": "string",
            "wage": 42,
            "years_experience": 42
          }
        ],
        "net_rate": 42
      }
    ],
    "status": "string"
  }
]

Create a policy

Creates a new policy object.

Body
  • created integer(int64)
  • effective_date integer(int64)

    A timestamp used to determine the insurance policy start date.

  • expiration_date integer(int64)

    A timestemp used to determine the insurance policy end date.

  • id string

    Unique identifier for the object.

  • pdf_url string

    A URL for the hosted insurnace policy PDF, which contractors can view.

  • quote object

    The Quote object reflects whether a contractor is eligible for insurance and the premium owed for every $100 earned.

    • contractor object

      A Contractor object represents the contractors that can accept one or more jobs on your platform. The API allows you to create, delete, and update contractors. You can retrieve individual contractors as well as a list of all contractors.

      • address object
        • country string

          2-letter country code.

        • line1 string

          Address line 1 (Street address/PO Box/Company name).

        • line2 string

          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.

      • company_name string

        The contractor's business name.

      • created integer(int64)
      • first_name string

        The contractor's first name.

      • id string

        Unique identifier for the object.

      • last_name string

        The contractor's last name.

      • phone string

        The contractor's phone number.

    • coverage_type object

      The types of insurance coverage available on the 1099Policy platform.

      • coverage_type

        Either general, professional or workers-comp.

        Values are general, professional, and workers-comp.

      • id string

        Unique identifier for the object.

    • created integer(int64)
    • eligible boolean

      Indicates whether a contractor is elgible for insurance or not.

      Default value is true.

    • id string

      Unique identifier for the object.

    • job object

      Store representations of the jobs on your platform in Job objects. The Job is used to, among other things, ensure that the insurance coverage that the 1099Policy platform issues correctly maps to the work that contractors will do.

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

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

      • entity object

        The Entity object represents the contracting entity responsible for defining the job descriptions and for hiring contractors.
        The API allows you to create, delete, and update entities. You can retrieve individual entities as well as a list of all entities.

        • address object
          • country string

            2-letter country code.

          • line1 string

            Address line 1 (Street address/PO Box/Company name).

          • line2 string

            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.

        • coverage_lmiit object
          • aggregate_limit integer

            The total amount the insurance company will pay for multiple claims over the course of one policy term.

          • id string

            Unique identifier for the object.

          • occurrence_limit integer

            The total amount the insurance company will pay per incident during the policy term.

        • created integer(int64)
        • id string

          Unique identifier for the object.

        • name string

          The contracting entity's legal name.

        • required_coverage object

          The types of insurance coverage available on the 1099Policy platform.

          • coverage_type

            Either general, professional or workers-comp.

            Values are general, professional, and workers-comp.

          • id string

            Unique identifier for the object.

      • id string

        Unique identifier for the object.

      • name string

        The name of the contractor job role.

      • review_status

        One of pending or reviewed.
        Every new job posting is reviewed by a 1099Policy broker and classified to correctly place insurance with our carrier partners.

        Values are pending and reviewed.

      • wage integer

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

        Minimum value is 100.

      • years_experience integer

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

    • net_rate integer

      The amount of money the 1099 contractor pays in premium per every $100 earned.
      A positive integer representing the premium owed per $100 earned. The net_rate is stored in cents (e.g., 48 represents $0.48).

      Minimum value is 50.

  • status

    One of active, cancelled, or expired.

    Values are active, cancelled, and expired.

Responses
  • 200 object

    The posted request body

    • created integer(int64)
    • effective_date integer(int64)

      A timestamp used to determine the insurance policy start date.

    • expiration_date integer(int64)

      A timestemp used to determine the insurance policy end date.

    • id string

      Unique identifier for the object.

    • pdf_url string

      A URL for the hosted insurnace policy PDF, which contractors can view.

    • quote object

      The Quote object reflects whether a contractor is eligible for insurance and the premium owed for every $100 earned.

      • contractor object

        A Contractor object represents the contractors that can accept one or more jobs on your platform. The API allows you to create, delete, and update contractors. You can retrieve individual contractors as well as a list of all contractors.

        • address object
          • country string

            2-letter country code.

          • line1 string

            Address line 1 (Street address/PO Box/Company name).

          • line2 string

            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.

        • company_name string

          The contractor's business name.

        • created integer(int64)
        • first_name string

          The contractor's first name.

        • id string

          Unique identifier for the object.

        • last_name string

          The contractor's last name.

        • phone string

          The contractor's phone number.

      • coverage_type object

        The types of insurance coverage available on the 1099Policy platform.

        • coverage_type

          Either general, professional or workers-comp.

          Values are general, professional, and workers-comp.

        • id string

          Unique identifier for the object.

      • created integer(int64)
      • eligible boolean

        Indicates whether a contractor is elgible for insurance or not.

        Default value is true.

      • id string

        Unique identifier for the object.

      • job object

        Store representations of the jobs on your platform in Job objects. The Job is used to, among other things, ensure that the insurance coverage that the 1099Policy platform issues correctly maps to the work that contractors will do.

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

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

        • entity object

          The Entity object represents the contracting entity responsible for defining the job descriptions and for hiring contractors.
          The API allows you to create, delete, and update entities. You can retrieve individual entities as well as a list of all entities.

          • address object
            • country string

              2-letter country code.

            • line1 string

              Address line 1 (Street address/PO Box/Company name).

            • line2 string

              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.

          • coverage_lmiit object
            • aggregate_limit integer

              The total amount the insurance company will pay for multiple claims over the course of one policy term.

            • id string

              Unique identifier for the object.

            • occurrence_limit integer

              The total amount the insurance company will pay per incident during the policy term.

          • created integer(int64)
          • id string

            Unique identifier for the object.

          • name string

            The contracting entity's legal name.

          • required_coverage object

            The types of insurance coverage available on the 1099Policy platform.

            • coverage_type

              Either general, professional or workers-comp.

              Values are general, professional, and workers-comp.

            • id string

              Unique identifier for the object.

        • id string

          Unique identifier for the object.

        • name string

          The name of the contractor job role.

        • review_status

          One of pending or reviewed.
          Every new job posting is reviewed by a 1099Policy broker and classified to correctly place insurance with our carrier partners.

          Values are pending and reviewed.

        • wage integer

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

          Minimum value is 100.

        • years_experience integer

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

      • net_rate integer

        The amount of money the 1099 contractor pays in premium per every $100 earned.
        A positive integer representing the premium owed per $100 earned. The net_rate is stored in cents (e.g., 48 represents $0.48).

        Minimum value is 50.

    • status

      One of active, cancelled, or expired.

      Values are active, cancelled, and expired.

POST /api/v1/policies
$ curl \
 -X POST //api.1099policy.com/api/v1/policies \
 -H "Content-Type: application/json" \
 -d '{"created":42,"effective_date":42,"expiration_date":42,"id":"string","pdf_url":"string","quote":{"contractor":{"address":{"country":"string","line1":"string","line2":"string","locality":"string","postalcode":"string","region":"string"},"company_name":"string","created":42,"first_name":"string","id":"string","last_name":"string","phone":"string"},"coverage_type":{"coverage_type":"general","id":"string"},"created":42,"eligible":true,"id":"string","job":{"category_code":"string","created":42,"d...}'
Request example
{
  "created": 42,
  "effective_date": 42,
  "expiration_date": 42,
  "id": "string",
  "pdf_url": "string",
  "quote": {
    "contractor": {
      "address": {
        "country": "string",
        "line1": "string",
        "line2": "string",
        "locality": "string",
        "postalcode": "string",
        "region": "string"
      },
      "company_name": "string",
      "created": 42,
      "first_name": "string",
      "id": "string",
      "last_name": "string",
      "phone": "string"
    },
    "coverage_type": {
      "coverage_type": "string",
      "id": "string"
    },
    "created": 42,
    "eligible": true,
    "id": "string",
    "job": {
      "category_code": "string",
      "created": 42,
      "description": "string",
      "entity": {
        "address": {
          "country": "string",
          "line1": "string",
          "line2": "string",
          "locality": "string",
          "postalcode": "string",
          "region": "string"
        },
        "coverage_lmiit": {
          "aggregate_limit": 42,
          "id": "string",
          "occurrence_limit": 42
        },
        "created": 42,
        "id": "string",
        "name": "string",
        "required_coverage": {
          "coverage_type": "string",
          "id": "string"
        }
      },
      "id": "string",
      "name": "string",
      "review_status": "string",
      "wage": 42,
      "years_experience": 42
    },
    "net_rate": 42
  },
  "status": "string"
}
Response example (200)
{
  "created": 42,
  "effective_date": 42,
  "expiration_date": 42,
  "id": "string",
  "pdf_url": "string",
  "quote": {
    "contractor": {
      "address": {
        "country": "string",
        "line1": "string",
        "line2": "string",
        "locality": "string",
        "postalcode": "string",
        "region": "string"
      },
      "company_name": "string",
      "created": 42,
      "first_name": "string",
      "id": "string",
      "last_name": "string",
      "phone": "string"
    },
    "coverage_type": {
      "coverage_type": "string",
      "id": "string"
    },
    "created": 42,
    "eligible": true,
    "id": "string",
    "job": {
      "category_code": "string",
      "created": 42,
      "description": "string",
      "entity": {
        "address": {
          "country": "string",
          "line1": "string",
          "line2": "string",
          "locality": "string",
          "postalcode": "string",
          "region": "string"
        },
        "coverage_lmiit": {
          "aggregate_limit": 42,
          "id": "string",
          "occurrence_limit": 42
        },
        "created": 42,
        "id": "string",
        "name": "string",
        "required_coverage": {
          "coverage_type": "string",
          "id": "string"
        }
      },
      "id": "string",
      "name": "string",
      "review_status": "string",
      "wage": 42,
      "years_experience": 42
    },
    "net_rate": 42
  },
  "status": "string"
}

Retrieve a policy

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

Body
  • job string

    The ID of the desired policy.

Responses
  • 200 object

    Returns a policy object if a valid ID was provided.

    • created integer(int64)
    • effective_date integer(int64)

      A timestamp used to determine the insurance policy start date.

    • expiration_date integer(int64)

      A timestemp used to determine the insurance policy end date.

    • id string

      Unique identifier for the object.

    • pdf_url string

      A URL for the hosted insurnace policy PDF, which contractors can view.

    • quote object

      The Quote object reflects whether a contractor is eligible for insurance and the premium owed for every $100 earned.

      • contractor object

        A Contractor object represents the contractors that can accept one or more jobs on your platform. The API allows you to create, delete, and update contractors. You can retrieve individual contractors as well as a list of all contractors.

        • address object
          • country string

            2-letter country code.

          • line1 string

            Address line 1 (Street address/PO Box/Company name).

          • line2 string

            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.

        • company_name string

          The contractor's business name.

        • created integer(int64)
        • first_name string

          The contractor's first name.

        • id string

          Unique identifier for the object.

        • last_name string

          The contractor's last name.

        • phone string

          The contractor's phone number.

      • coverage_type object

        The types of insurance coverage available on the 1099Policy platform.

        • coverage_type

          Either general, professional or workers-comp.

          Values are general, professional, and workers-comp.

        • id string

          Unique identifier for the object.

      • created integer(int64)
      • eligible boolean

        Indicates whether a contractor is elgible for insurance or not.

        Default value is true.

      • id string

        Unique identifier for the object.

      • job object

        Store representations of the jobs on your platform in Job objects. The Job is used to, among other things, ensure that the insurance coverage that the 1099Policy platform issues correctly maps to the work that contractors will do.

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

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

        • entity object

          The Entity object represents the contracting entity responsible for defining the job descriptions and for hiring contractors.
          The API allows you to create, delete, and update entities. You can retrieve individual entities as well as a list of all entities.

          • address object
            • country string

              2-letter country code.

            • line1 string

              Address line 1 (Street address/PO Box/Company name).

            • line2 string

              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.

          • coverage_lmiit object
            • aggregate_limit integer

              The total amount the insurance company will pay for multiple claims over the course of one policy term.

            • id string

              Unique identifier for the object.

            • occurrence_limit integer

              The total amount the insurance company will pay per incident during the policy term.

          • created integer(int64)
          • id string

            Unique identifier for the object.

          • name string

            The contracting entity's legal name.

          • required_coverage object

            The types of insurance coverage available on the 1099Policy platform.

            • coverage_type

              Either general, professional or workers-comp.

              Values are general, professional, and workers-comp.

            • id string

              Unique identifier for the object.

        • id string

          Unique identifier for the object.

        • name string

          The name of the contractor job role.

        • review_status

          One of pending or reviewed.
          Every new job posting is reviewed by a 1099Policy broker and classified to correctly place insurance with our carrier partners.

          Values are pending and reviewed.

        • wage integer

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

          Minimum value is 100.

        • years_experience integer

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

      • net_rate integer

        The amount of money the 1099 contractor pays in premium per every $100 earned.
        A positive integer representing the premium owed per $100 earned. The net_rate is stored in cents (e.g., 48 represents $0.48).

        Minimum value is 50.

    • status

      One of active, cancelled, or expired.

      Values are active, cancelled, and expired.

GET /api/v1/policies/{policy_id}
$ curl \
 -X GET //api.1099policy.com/api/v1/policies/{policy_id} \
 -H "Content-Type: application/json" \
 -d '{"job":"string"}'
Request example
{
  "job": "string"
}
Response example (200)
{
  "created": 42,
  "effective_date": 42,
  "expiration_date": 42,
  "id": "string",
  "pdf_url": "string",
  "quote": {
    "contractor": {
      "address": {
        "country": "string",
        "line1": "string",
        "line2": "string",
        "locality": "string",
        "postalcode": "string",
        "region": "string"
      },
      "company_name": "string",
      "created": 42,
      "first_name": "string",
      "id": "string",
      "last_name": "string",
      "phone": "string"
    },
    "coverage_type": {
      "coverage_type": "string",
      "id": "string"
    },
    "created": 42,
    "eligible": true,
    "id": "string",
    "job": {
      "category_code": "string",
      "created": 42,
      "description": "string",
      "entity": {
        "address": {
          "country": "string",
          "line1": "string",
          "line2": "string",
          "locality": "string",
          "postalcode": "string",
          "region": "string"
        },
        "coverage_lmiit": {
          "aggregate_limit": 42,
          "id": "string",
          "occurrence_limit": 42
        },
        "created": 42,
        "id": "string",
        "name": "string",
        "required_coverage": {
          "coverage_type": "string",
          "id": "string"
        }
      },
      "id": "string",
      "name": "string",
      "review_status": "string",
      "wage": 42,
      "years_experience": 42
    },
    "net_rate": 42
  },
  "status": "string"
}

Update a policy

Policies can be switched on and off using the is_active flag.
Use this functionality if you don't have preset policy
start and end times.

Body
  • created integer(int64)
  • effective_date integer(int64)

    A timestamp used to determine the insurance policy start date.

  • expiration_date integer(int64)

    A timestemp used to determine the insurance policy end date.

  • id string

    Unique identifier for the object.

  • pdf_url string

    A URL for the hosted insurnace policy PDF, which contractors can view.

  • quote object

    The Quote object reflects whether a contractor is eligible for insurance and the premium owed for every $100 earned.

    • contractor object

      A Contractor object represents the contractors that can accept one or more jobs on your platform. The API allows you to create, delete, and update contractors. You can retrieve individual contractors as well as a list of all contractors.

      • address object
        • country string

          2-letter country code.

        • line1 string

          Address line 1 (Street address/PO Box/Company name).

        • line2 string

          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.

      • company_name string

        The contractor's business name.

      • created integer(int64)
      • first_name string

        The contractor's first name.

      • id string

        Unique identifier for the object.

      • last_name string

        The contractor's last name.

      • phone string

        The contractor's phone number.

    • coverage_type object

      The types of insurance coverage available on the 1099Policy platform.

      • coverage_type

        Either general, professional or workers-comp.

        Values are general, professional, and workers-comp.

      • id string

        Unique identifier for the object.

    • created integer(int64)
    • eligible boolean

      Indicates whether a contractor is elgible for insurance or not.

      Default value is true.

    • id string

      Unique identifier for the object.

    • job