BigChange

BigChange is an all-in-one field service and job management platform (CRM, job scheduling, live tracking, a mobile workforce app, job finance, and business intelligence) known as JobWatch. Its modern REST API - the BigChange DX API at https://api.bigchange.com - lets developers manage jobs, contacts and persons, quotes, invoices and purchase orders, stock, resources, users and vehicles, worksheets, and assets, plus subscribe to webhooks. Requests are authenticated with a Bearer JWT access token (obtained through BigChange's authentication proxy from a developer-portal API key) and scoped with a required Customer-Id header.

9 APIs 0 Features
Field Service ManagementJob ManagementSchedulingWorkforce ManagementFleetCRMSaaS

APIs

BigChange Jobs API

Create, retrieve, update, schedule, start, cancel, and report on jobs and job groups. Manage job line items, job stock, worksheets and answers, constraints, flags, and status hi...

BigChange Contacts and Persons API

Manage customer contacts and contact groups, put contacts on/off stop, set site access hours, and manage persons together with their data-consent history - the CRM core of the J...

BigChange Finance API

Manage invoices, quotes, purchase orders, and sales opportunities and their line items - create and update documents, mark invoices paid/sent, accept or reject quotes, and gener...

BigChange Stock and Inventory API

Manage stock items, stock details and suppliers, and read stock movement records - the parts and inventory used to complete field-service jobs.

BigChange Resources, Users and Vehicles API

Manage the mobile workforce and fleet - resources and resource groups, back-office users, and vehicles - that jobs are scheduled and dispatched against.

BigChange Notes and Worksheets API

Create and manage notes and note types with progress history, and read worksheets, worksheet groups, and worksheet questions used to capture structured job data on the JobWatch ...

BigChange Reference Data API

Read-only lookups that back the rest of the platform - VAT codes, nominal codes, department codes, product categories, job types, note types, and sales-opportunity stages and pr...

BigChange Asset Management API

Manage customer assets and their categories, attributes, images, and service schedules, plus service agreements and their activities - under the /asset-management/v1 path. Publi...

BigChange Webhooks API

List webhook subscriptions and inspect, retry, or clear failed webhook deliveries under /webhooks/v1. Webhooks are outbound HTTP callbacks (server-to-consumer POST), not a WebSo...

Collections

BigChange DX REST API

OPEN

Pricing Plans

Bigchange Plans Pricing

3 plans

PLANS

Rate Limits

Bigchange Rate Limits

3 limits

RATE LIMITS

FinOps

Bigchange Finops

FINOPS

Resources

🔗
AgenticAccess
AgenticAccess
🔗
DomainSecurity
DomainSecurity
🔑
Authentication
Authentication
🔗
LinkedIn
LinkedIn
🔗
Website
Website
🔗
Documentation
Documentation
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps
📰
Blog
Blog

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: BigChange DX REST API
  version: '1.0'
request:
  auth:
    type: bearer
    token: '{{accessToken}}'
items:
- info:
    name: Jobs
    type: folder
  items:
  - info:
      name: Get a list of jobs
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/jobs
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns a paged list of jobs. Filter by type, contact, resource, order number, and created-at range.
  - info:
      name: Create a job
      type: http
    http:
      method: POST
      url: https://api.bigchange.com/v1/jobs
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
      body:
        type: json
        data: '{}'
    docs: Creates a new job.
  - info:
      name: Get a job
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/jobs/:jobId
      params:
      - name: jobId
        value: ''
        type: path
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Retrieves a single job by id.
  - info:
      name: Update a job
      type: http
    http:
      method: PATCH
      url: https://api.bigchange.com/v1/jobs/:jobId
      params:
      - name: jobId
        value: ''
        type: path
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
      body:
        type: json
        data: '{}'
    docs: Updates an existing job.
  - info:
      name: Schedule or unschedule a job
      type: http
    http:
      method: PUT
      url: https://api.bigchange.com/v1/jobs/:jobId/schedule
      params:
      - name: jobId
        value: ''
        type: path
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
      body:
        type: json
        data: '{}'
    docs: Assigns a job to a resource and time slot, or unschedules it.
  - info:
      name: Set a job to started
      type: http
    http:
      method: PUT
      url: https://api.bigchange.com/v1/jobs/:jobId/start
      params:
      - name: jobId
        value: ''
        type: path
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Marks a job as started.
  - info:
      name: Set a job's result
      type: http
    http:
      method: PUT
      url: https://api.bigchange.com/v1/jobs/:jobId/result
      params:
      - name: jobId
        value: ''
        type: path
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
      body:
        type: json
        data: '{}'
    docs: Records the result/outcome of a job.
  - info:
      name: Cancel a job
      type: http
    http:
      method: PUT
      url: https://api.bigchange.com/v1/jobs/:jobId/cancel
      params:
      - name: jobId
        value: ''
        type: path
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Cancels a job.
  - info:
      name: Get a list of job groups
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/jobGroups
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns a paged list of job groups.
  - info:
      name: Get a list of job types
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/jobTypes
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns available job types (reference data).
- info:
    name: Contacts and Persons
    type: folder
  items:
  - info:
      name: Get a list of contacts
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/contacts
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns a paged list of contacts.
  - info:
      name: Create a contact
      type: http
    http:
      method: POST
      url: https://api.bigchange.com/v1/contacts
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
      body:
        type: json
        data: '{}'
    docs: Creates a new contact.
  - info:
      name: Get a contact
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/contacts/:contactId
      params:
      - name: contactId
        value: ''
        type: path
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Retrieves a single contact.
  - info:
      name: Put a contact on stop
      type: http
    http:
      method: PUT
      url: https://api.bigchange.com/v1/contacts/:contactId/stop
      params:
      - name: contactId
        value: ''
        type: path
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Places a contact on stop.
  - info:
      name: Get a list of contact groups
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/contactGroups
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns contact groups.
  - info:
      name: Get a list of persons
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/persons
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns a paged list of persons.
  - info:
      name: Create a person
      type: http
    http:
      method: POST
      url: https://api.bigchange.com/v1/persons
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
      body:
        type: json
        data: '{}'
    docs: Creates a new person.
- info:
    name: Finance
    type: folder
  items:
  - info:
      name: Get a list of invoices
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/finance/invoices
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns a paged list of invoices.
  - info:
      name: Create an invoice
      type: http
    http:
      method: POST
      url: https://api.bigchange.com/v1/finance/invoices
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
      body:
        type: json
        data: '{}'
    docs: Creates a new invoice.
  - info:
      name: Mark an invoice as paid
      type: http
    http:
      method: PUT
      url: https://api.bigchange.com/v1/finance/invoices/:invoiceId/paid
      params:
      - name: invoiceId
        value: ''
        type: path
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Marks an invoice as paid.
  - info:
      name: Mark an invoice as sent
      type: http
    http:
      method: PUT
      url: https://api.bigchange.com/v1/finance/invoices/:invoiceId/sent
      params:
      - name: invoiceId
        value: ''
        type: path
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Marks an invoice as sent.
  - info:
      name: Get a list of quotes
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/finance/quotes
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns a paged list of quotes.
  - info:
      name: Create a quote
      type: http
    http:
      method: POST
      url: https://api.bigchange.com/v1/finance/quotes
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
      body:
        type: json
        data: '{}'
    docs: Creates a new quote.
  - info:
      name: Get a list of purchase orders
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/finance/purchaseOrders
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns a paged list of purchase orders.
  - info:
      name: Get a list of sales opportunities
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/finance/salesOpportunities
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns a paged list of sales opportunities.
- info:
    name: Stock
    type: folder
  items:
  - info:
      name: Get a list of stock items
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/stockItems
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns a paged list of stock items.
  - info:
      name: Create a stock item
      type: http
    http:
      method: POST
      url: https://api.bigchange.com/v1/stockItems
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
      body:
        type: json
        data: '{}'
    docs: Creates a new stock item.
  - info:
      name: Get a list of stock details
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/stockDetails
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns stock details.
  - info:
      name: Get a list of stock movements
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/stockMovement
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns stock movement records.
- info:
    name: Resources, Users and Vehicles
    type: folder
  items:
  - info:
      name: Get a list of resources
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/resources
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns the mobile workforce resources.
  - info:
      name: Get a list of resource groups
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/resourceGroups
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns resource groups.
  - info:
      name: Gets a list of users
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/users
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns back-office users.
  - info:
      name: Get a list of vehicles
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/vehicles
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns fleet vehicles.
  - info:
      name: Create a vehicle
      type: http
    http:
      method: POST
      url: https://api.bigchange.com/v1/vehicles
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
      body:
        type: json
        data: '{}'
    docs: Creates a new vehicle.
- info:
    name: Notes and Worksheets
    type: folder
  items:
  - info:
      name: Get a list of notes
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/notes
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns a paged list of notes.
  - info:
      name: Create a note
      type: http
    http:
      method: POST
      url: https://api.bigchange.com/v1/notes
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
      body:
        type: json
        data: '{}'
    docs: Creates a new note.
  - info:
      name: Get a list of note types
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/noteTypes
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns note types.
  - info:
      name: Get a list of worksheets
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/worksheets
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns worksheets.
  - info:
      name: Get a list of worksheet groups
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/worksheetGroups
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns worksheet groups.
- info:
    name: Reference Data
    type: folder
  items:
  - info:
      name: Get a list of VAT codes
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/vatCodes
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns VAT codes.
  - info:
      name: Get a list of nominal codes
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/nominalCodes
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns nominal codes.
  - info:
      name: Get a list of department codes
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/departmentCodes
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns department codes.
  - info:
      name: Get a list of product categories
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/v1/productCategories
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns product categories.
- info:
    name: Asset Management
    type: folder
  items:
  - info:
      name: Get a list of assets
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/asset-management/v1/assets
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns customer assets.
  - info:
      name: Create an asset
      type: http
    http:
      method: POST
      url: https://api.bigchange.com/asset-management/v1/assets
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
      body:
        type: json
        data: '{}'
    docs: Creates a new asset.
  - info:
      name: Search assets
      type: http
    http:
      method: POST
      url: https://api.bigchange.com/asset-management/v1/assets/search
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
      body:
        type: json
        data: '{}'
    docs: Searches assets by criteria.
  - info:
      name: Get a list of service agreements
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/asset-management/v1/serviceAgreements
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Returns service agreements.
- info:
    name: Webhooks
    type: folder
  items:
  - info:
      name: Get webhook subscriptions
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/webhooks/v1/subscriptions
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Lists webhook subscriptions.
  - info:
      name: Get failed webhook deliveries
      type: http
    http:
      method: GET
      url: https://api.bigchange.com/webhooks/v1/failed
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
    docs: Lists failed webhook deliveries.
  - info:
      name: Retry failed webhook deliveries
      type: http
    http:
      method: POST
      url: https://api.bigchange.com/webhooks/v1/failed/retry
      headers:
      - name: Customer-Id
        value: '{{customerId}}'
      body:
        type: json
        data: '{}'
    docs: Retries failed webhook deliveries.