REST API · Webhooks · OAuth 2.0

COI Tracking API for Contractor and Vendor Compliance

Your contractors' compliance status, in the systems that pay them and put them on site.

Read each sub's compliance status and the reasons behind it, add contractors from your own tools, email them their upload link, and get a webhook the moment a certificate of insurance or a licence nears expiration. JSON over HTTPS, an API key or OAuth 2.0, and the same rules as the app.

GET /api/v1/contractors?email=office@ridgeline.example
{
  "data": [{
    "id": 412,
    "name": "Ridgeline Electric",
    "email": "office@ridgeline.example",
    "active": true,
    "compliance_status": "not_compliant",
    "compliance_reasons": [
      "The certificate from Travelers expired Sep 1, 2026"
    ],
    "url": "https://trackmyvendor.com/app/vendors/412"
  }],
  "meta": {
    "page": 1, "per_page": 25,
    "total": 1, "has_more": false
  }
}

How the COI tracking API works

TrackMyVendor still does the collecting: subs upload through a link, certificates are read automatically, licences are checked against state databases. The API is how that result reaches your other systems.

1

Authenticate

Use the workspace's API key for your own scripts, or OAuth 2.0 for an app people connect to their account. Either one acts in exactly one workspace.

2

Read and write contractors

Look up a contractor's compliance status before you pay them or send them to site; add contractors and request their documents from the tool where they first appear.

3

Subscribe to events

Register an HTTPS URL for certificate, licence, W-9 and status events. Each delivery is signed, so you can check it came from us.

What the vendor compliance API gives you

Every call goes through the same code as the screens, so the API cannot disagree with what your team sees.

Compliance status for every contractor

Each contractor comes back with the same badge your team sees — compliant, not_compliant or no_documents — and the reasons behind it, with your required documents and project requirements counted.

Certificate of insurance expiration events

contractor.coi_expiring fires when a certificate, or one policy on it, enters one of your alert windows, carrying the carrier, the policy and the date. License expirations arrive the same way.

Add and update contractors

Create a contractor from your CRM, onboarding form or ERP, and change their contact details, active flag or auto-reminders later. Your plan's contractor limit and unique names apply, exactly as on screen.

Request documents

Email a contractor their upload link — the same email as Request Documents in the app, listing everything they owe. They upload COIs, W-9s and licences from their phone, with no account.

Subscribe and unsubscribe webhooks

Point an HTTPS URL at any of the five events and remove it again, from code. Deliveries are signed, retried, and carry a stable event id so you can deduplicate.

Sample events on demand

Ask for an example of any event, built from your own contractors in exactly the shape a delivery arrives in, so you can build the receiving end without waiting for a certificate to lapse.

Endpoints and webhook events

At a glance. Parameters, response shapes and every error code are in the API reference.

EndpointWhat it does
GET /api/v1/me Which workspace the credential acts in
GET /api/v1/contractors Contractors with their compliance status — filter, search, sort, page
GET /api/v1/contractors/:id One contractor
POST /api/v1/contractors Add a contractor, optionally emailing their upload link
PATCH /api/v1/contractors/:id Change a contractor
POST /api/v1/contractors/:id/document_requests Email a contractor their upload link
GET /api/v1/events?type= Example events built from your data
POST /api/v1/hooks Subscribe a URL to an event
DELETE /api/v1/hooks/:id Unsubscribe it
EventFires when
contractor.created A contractor is added, any way
contractor.compliance_changed Their compliance badge changes — checked each morning
contractor.coi_expiring A certificate or one of its policies enters an alert window
contractor.license_expiring A licence enters an alert window
contractor.w9_missing A contractor no longer has a W-9 on file
contractor.approved A prospect you were vetting is approved, with or without conditions
contractor.declined A prospect you were vetting is declined
contractor.added_to_roster An approved prospect joins your contractors list

Expiring events fire at each of your alert windows — 90, 60, 30 and 7 days out by default.

What teams build with it

Small pieces of glue, not an implementation project.

Hold a payment until the COI is current

Before a bill is approved in your accounting system or ERP, check the contractor's compliance_status and show the approver the reason when it is not compliant.

Onboard from the form you already use

When a sub fills in your prequalification or onboarding form, create them here with request_documents set, and their upload link goes out at once.

Open a ticket before a certificate lapses

Route contractor.coi_expiring into your ticketing or project tool, assigned to whoever owns that sub, with the policy and the date in the ticket.

Keep a compliance column in your own reports

Page through contractors nightly into your warehouse or BI tool, so a roster report anywhere in the business carries the current status.

What the API does, and what it doesn't

  • Same rules as the app. Your contractor limit, unique names and the 48-hour pause between emails to one contractor all hold; a send inside the pause answers 409 cooldown unless you force it. Changes show in the contractor's activity, marked as coming from the API.
  • One workspace per credential. An API key or token never reaches another workspace, and a token stops working the moment its person loses access or disconnects the app.
  • Safe webhook targets only. Addresses on private networks are refused when you subscribe and again before every delivery.
  • No document files, yet. The API does not upload or download COI, W-9 or licence files. Contractors upload through their link, and the API tells you the result.
  • OAuth apps are registered by us. The API key is self-serve; an OAuth client for an app other people will connect is set up on request.

Simple, transparent pricing

The API and webhooks are part of Pro, and the QuickBooks Online connection is on Starter too. Every plan starts free, and paid plans include a 30-day trial.

30-DAY FREE TRIAL — No credit card required

Free

$0
Up to 25 subcontractors · 1 user

Organize your roster and run COI tracking at zero cost. Free forever, no credit card.

  • ✓AI COI parsing & W-9 parsing — carriers, limits, dates and TINs read for you
  • ✓50-state license tracking, plus automated license verification against state databases
  • ✓Secure link onboarding — documents arrive through a secure upload link, no account needed
  • ✓Document vault — contracts, licenses, W-9s and insurance, filed by category
  • ✓Weekly compliance digest — a summary email of upcoming expirations
  • ✓Timestamped audit trail — the full history of every certificate
  • –Renewal reminders are sent by you — one click emails the upload link
Most Popular

Starter

$39/mo
Up to 200 subcontractors · 2 users

Flat, predictable pricing for active general contractors and property managers.

  • ✓Everything in Free
  • ✓Up to 200 subcontractors — eight times Free’s 25, with no per-record fees
  • ✓Automated renewal reminders — email alerts at 90/60/30/7 days to your team and the subcontractor
  • ✓Projects & job sites — group subcontractors by job, with per-project coverage rules
  • ✓Calendar feed — deadlines live in Google Calendar, Outlook or Apple Calendar
  • ✓Bulk roster import — from a CSV or a certificate archive
  • ✓QuickBooks Online — compliance status on each matched vendor record, kept current automatically
  • ✓2 user seats — invite a second team member or coordinator

Pro

$59/mo
Unlimited subcontractors · Unlimited users

Full automation, endorsement checks and integrations for growing teams.

  • ✓Everything in Starter
  • ✓Unlimited subcontractors — past Starter’s 200, still with no per-record fees
  • ✓AI endorsement verification — reads the additional insured, waiver of subrogation and primary & non-contributory pages
  • ✓Unlimited users & roles — access for foremen, office managers and admins
  • ✓API & integrations — the API, webhooks, Zapier, Make, Slack and Teams
  • ✓Insurance audit report — every sub's coverage and gaps over your policy year, for the premium audit
  • ✓Third-party categories — vendors, tenants, renters and franchisees on their own lists
  • ✓QuickBooks auto-sync — new and changed QuickBooks vendors reach your roster within minutes
Add-on

PreQual

$69/mo, flat

Add to Starter or Pro. Not available on Free.

Vet subs from their documents, not a questionnaire.

  • ✓Prospects — send a sub one link with your own questionnaire to fill in, see what's in, then approve up to a job size, approve with conditions or decline
  • ✓Safety documents read for you — the EMR from the EMR letter, TRIR and DART from the OSHA 300A
  • ✓Three years of 300As — 3-year TRIR and DART beside the BLS average for the sub's trade
  • ✓A scorecard per sub — each check against your limits, no overall score; compare up to five side by side
  • ✓Bonding letters read — surety and limits against your minimum
  • ✓Re-qualification and Export for Bids — ask approved subs again every 12 or 24 months; list who’s qualified for the job size and copy their emails
Start a Starter trial then add PreQual from Settings → Billing, anytime. How PreQual works

Figures are read from the documents, not verified with the carrier, rating bureau, surety or OSHA.

Add-on

Onsite

$49/site/mo

For each job site switched on, on Starter or Pro. Not available on Free.

Know who is on site, and that their company is covered.

  • ✓A QR poster at the gate — workers scan with the phone camera, no app or account, in English or Spanish
  • ✓Each crew checked on arrival — the company’s certificate of insurance and license, against your requirements
  • ✓Monitor first, enforce when ready — see who would be turned away before you turn anyone away
  • ✓A live roster — who’s on site by company, one-day passes, an updated COI requested automatically
  • ✓Evening heads-up — which companies would be stopped tomorrow, the night before
  • ✓End-of-day headcount — by company, with visitors and hours, for the daily report
Start a Starter trial then add Onsite from Settings → Billing. $0 until you switch a site on. How Onsite works

Ending a site stops its charge, prorated. Workers pay nothing and are never texted or emailed.

No contracts. Cancel anytime. See the full plan comparison →

COI tracking API: common questions

Is there a certificate of insurance API?
Yes. The TrackMyVendor API returns each contractor's compliance status — worked out from their certificates of insurance, licences, W-9s and your required documents — and sends a contractor.coi_expiring webhook when a certificate or one of its policies enters an alert window, with the carrier, policy and expiration date. It does not take or return the certificate PDF itself: certificates arrive through the contractor's upload link and are read there.
How does the API authenticate?
Two ways, both as a Bearer token in the Authorization header. An API key, generated by a workspace owner, is for your own scripts. OAuth 2.0 (authorization code, with refresh tokens and PKCE) is for apps people connect to their account; OAuth clients are registered by us rather than self-serve, so get in touch with your app's name and redirect URI.
Which plan includes the API?
Pro. The API key, OAuth connections and webhooks are all part of Pro, which has a 30-day free trial with no credit card. The QuickBooks Online connection is also on Starter. If a workspace's plan stops including integrations, requests are refused until it does again; nothing is deleted.
Can I hold a payment when a contractor's COI has lapsed?
Yes, from your side. Look the contractor up by email or name before a bill is approved and check compliance_status; compliance_reasons says what is wrong in words you can show the approver. Teams on QuickBooks Online can skip the code: the native connection puts the same status on the vendor record.
What are the rate limits?
120 requests a minute per workspace. Over that, the API answers 429 with the code rate_limited. Lists page at up to 100 contractors a request.
Can I upload a COI or W-9 through the API?
Not yet. The API can email a contractor their upload link, and the contractor uploads from their phone without an account; the certificate is then read automatically. Uploading a file through the API itself is planned but not built.
Does it work with Zapier and Make?
Yes. The same five events reach Zapier and Make through webhooks today, with no code, and the setup guides on the integrations page walk through each one.

Put compliance status where the decisions get made

Start free, switch on Pro for 30 days, and make your first call in minutes.

Get started free — no credit card

Explore More

Integrations

Connect compliance alerts to the tools your team already uses

Zapier Contractor Compliance

Route COI, license & W-9 alerts to 6,000+ apps via Zapier

Make Contractor Compliance (Integromat)

Build Make scenarios for COI expiry, license lapses & W-9 alerts

Contractor Compliance Automation

How to automate COI parsing, license verification, and W-9 collection

Alerts and Reminders

Get notified before documents expire

Compliance Status & Reports

Every contractor red or green at a glance, and dated PDF and Excel reports

AI COI Parsing

Reads dates, limits and carriers from every certificate

COI Tracking Software

Collect, read and track every certificate of insurance

Plans & Pricing

View plans and start your free trial