Change bound coverage dates

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://docs.1099policy.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "1099Policy MCP server": {
    "url": "https://docs.1099policy.com/mcp"
  }
}

POST /api/v1/assignments/change_dates

Changes the start (effective_date) and/or end date of bound coverage for a job. This is the symmetric counterpart to POST /api/v1/assignments/extend: extend moves the end date out, this endpoint can also move the start date forward (shortening coverage from the front) -- e.g. correcting a start date that slipped into the past -- and it works for both quote- and assignment-backed coverage.

Restrictions mirror what we already enforce: effective_date must be in the future, strictly after the current start, and before the end date; end_date follows the extend rules (on or after the current end, within a year of the effective date, and coverage not already ended). At least one of effective_date / end_date is required. Changing dates on a bound quote via PUT /quotes is not supported; use this endpoint.

Certificate of Insurance (COI) regeneration: COI PDFs are regenerated asynchronously to reflect the new dates. The response returns immediately with certificate_refresh_pending: true; the certificate URLs in the response are stale, and fresh URLs are published in the assignment.dates_changed webhook (and available via the API) once regeneration completes.

application/json

Body

effective_date integer(int64)

New coverage start date (seconds since the Unix epoch). Must be in the future, after the current start, and before the end date. Moving it forward shortens coverage from the start.
end_date integer(int64)

New coverage end date (seconds since the Unix epoch). Must be on or after the current end date and within one year of the effective date.
job_id string Required

The ID of the job associated with the coverage.
send_email boolean

When true, email the contractor a coverage-dates-changed notice. COI regeneration and webhook publication happen regardless of this flag.

Default value is true.

Responses

200 application/json

Coverage dates updated, or unchanged (no-op) when the submitted dates match the current values. COIs regenerate asynchronously, so the response includes certificate_refresh_pending: true.
One of:
Assignment object Quote object
To secure coverage for independent contractors that have previously had a policy issued through the 1099Policy platform, you create an Assignment object.

Independent contractors with an existing insurance policy procured using the 1099Policy platform have the option to receive per-job-assignment insurance coverage without having to complete additional insurance applications, provided certain eligibility criteria are met.

You can find the result of the eligibility check in the API response. Eligiblity is determined by parameters provided, including job and contractor. In particular, we look to see if the job category_code is the same as previously approved and the time since the independent contractor completed their insurance application.

1099Policy automatically charges the independent contractor's credit card on file, if a credit card exists and bind is true. 1099Policy first notifies the contractor via email and then charges the contractor the premium amount due 24hrs later.

Hide attributes Show attributes

bind

Indicates whether to start the process of binding coverage, which includes notifying and subsequently charging the independent contractor for the premium amount due. Defaults to true. When false, 1099Policy does not notify or schedule a charge. Note that the independent contractor will not be issued coverage if bind is set to false.

Default value is true.

certificates object

URLs to the certificates of insurance for each of the types of coverage issued to the contractor for the specific job assignment.

Hide certificates attributes Show certificates attributes object

gl_coi_pdf_url string

The general liability certificate of insurance PDF URL.

wc_coi_pdf_url string

The workers compensation certificate of insurance PDF URL.

contractor string

ID of the contractor.

coverage_type array[string]

An array of coverage types that can include one or more of the following insurance coverage values: general, professional and workers-comp. If provided, coverage type is factored into the eligibility determination (i.e., does contractor have an active workers-comp policy, etc). Defaults to the coverage types of the most recent active policy if coverage_type is not provided.

Values are general, professional, or workers-comp.

created integer(int64)

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

effective_date integer(int64)

The job assignment start date, measured in seconds since the Unix epoch.

eligible object

Indicates whether a contractor is elgible for pre-approved insurance or not based on their most recent insurance application.

Hide eligible attributes Show eligible attributes object

message string

A message with more detail related to the eligibility result.

result boolean

The result of the insurance eligibility check.

end_date integer(int64)

The projected job assignment end date, measured in seconds since the Unix epoch.

id string

Unique identifier for the object.

job string

ID of the job that the contractor intends to accept.

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

policy string

ID of the policy that you want attached to the assignment. Defaults to the most recent active policy with a matching job category code, work state and contractor home state.
The Quote object reflects whether a contractor is eligible for insurance and the premium owed for every $100 earned.

Important note: In North Dakota, Ohio, Washington and Wyoming, workers compensation can only be purchased through a government operated insurance company. As a result, the quote API returns an error when a quote request is made for workers compensiation for any one of these four states.

Hide attributes Show attributes

contractor string

ID of the contractor.

coverage_type array[string]

An array of coverage types that can include one or more of the following insurance coverage values: general, professional, workers-comp, media, and cyber.

Values are general, professional, workers-comp, media, or cyber.

created integer(int64)

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

effective_date string(int64)

The date when the insurance coverage is set to take effect. Measured in seconds since the Unix epoch. This date must be set in the future. The default effective_date is the next day.

eligible boolean

Indicates whether a contractor is elgible for insurance or not.

Default value is true.

end_date string(int64)

The date when the insurance coverage is set to expire. Measured in seconds since the Unix epoch. This date must be after the effective date. The default end_date is 30 days after the effective date.

gl_net_rate integer

The amount of money the 1099 contractor pays in general liability premium per every $100 earned.

A positive integer representing the premium owed per $100 earned. The gl_net_rate is stored in cents (e.g., 48 represents $0.48).

id string

Unique identifier for the object.

job string

ID of the job that the contractor was paid to do.

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

quote_json object

The JSON representation of component parts that make up the total premium amount due including, for example, the net rate, taxes, and fees.

wc_net_rate integer

The amount of money the 1099 contractor pays in workers comp premium per every $100 earned.

A positive integer representing the premium owed per $100 earned. The wc_net_rate is stored in cents (e.g., 48 represents $0.48).
400

Invalid input, no dates provided, voided/cancelled/unbound record, expired coverage, a backward or past effective_date, or a shortened end_date.
404

Job not found, or no bound coverage found for the job.

POST /api/v1/assignments/change_dates

curl \
 --request POST 'https://api.1099policy.com/api/v1/assignments/change_dates' \
 --header "Content-Type: application/json" \
 --data '"{\n  \"effective_date\": 1784332800,\n  \"job_id\": \"jb_jsb9KEcTpc\",\n  \"send_email\": true\n}"'

Request example

{
  "effective_date": 1784332800,
  "job_id": "jb_jsb9KEcTpc",
  "send_email": true
}

Response examples (200)

{
  "bind": true,
  "certificates": {
    "gl_coi_pdf_url": "/bound-policies/prod/gl_coi_pl_wv23Q3lMc1_1691450123.pdf",
    "wc_coi_pdf_url": "/bound-policies/prod/wc_coi_pl_wv23Q3lMc1_1691420903.pdf"
  },
  "contractor": "cn_Ehb3bYa",
  "coverage_type": [
    "general",
    "workers-comp"
  ],
  "created": 1646818364,
  "effective_date": 1646818364,
  "eligible": {
    "message": "Contractor is pre-approved for insurance coverage.",
    "result": true
  },
  "end_date": 1678334737,
  "id": "an_5HviNgc2Br",
  "job": "jb_jsb9KEcTpc",
  "net_rate": 65,
  "policy": "pl_WzFRszJhoY"
}

{
  "contractor": "cn_Ehb3bYa",
  "coverage_type": [
    "general",
    "workers-comp"
  ],
  "created": 1646818364,
  "effective_date": 1646818364,
  "eligible": true,
  "end_date": 1678334737,
  "gl_net_rate": 20,
  "id": "qt_5DciVga8Kt",
  "job": "jb_jsb9KEcTpc",
  "net_rate": 65,
  "quote_json": {
    "gl": {
      "net_rate": 20,
      "risk_purchasing_group_fee": null,
      "stamping_fee": null
    },
    "wc": {
      "net_rate": 45
    }
  },
  "wc_net_rate": 45
}