Fergus API

Name: Fergus API API
Brand: Fergus API
Availability: InStock

✓ Official Vendor SpecProductivityTask Managementbearer,oauth274 EndpointsREST

For Agents

Manage trade-services jobs, quotes, invoices, time entries, and calendar events for plumbers and electricians using Fergus, with bearer token or OAuth2 auth.

Connect the Fergus API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Fergus API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Fergus API API.

Create and update jobs with phases, statuses, and assigned tradespeople

Generate quotes against jobs and convert them into customer invoices

Track time entries logged by field staff against specific jobs

Schedule calendar events tied to jobs and assigned users

GET STARTED

Start building with Fergus API API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Fergus API API for, with concrete tasks.

★ Quote-to-Invoice Trade Workflow

Automate the path from job creation through quote acceptance to invoice issue for trades businesses. The Fergus API exposes /jobs, /jobs/{id}/quotes, and /customer-invoices as related endpoints so an agent can move work through pipeline stages without manual data entry. Eliminates the typical 15-20 minute admin overhead per job common in plumbing and electrical contractors.

Create a job, attach a quote with three line items, finalise it via PUT /jobs/{jobId}/finalise, then generate the customer invoice

Field Staff Time Tracking

Pull time entries logged by tradespeople against jobs to compute payroll hours and job profitability. The Fergus API surfaces time entries with job and user filters, so an agent can summarise hours per job, per person, or per period. This replaces spreadsheet-based timesheet collation common in small trades businesses.

GET /time-entries filtered by user_id and date range for the last fortnight, sum hours per jobId, and return the top 5 jobs by labour cost

Customer and Site Lookup

Use Fergus's substring search parameters such as filterSearchText to find customers, sites, or jobs without exact-match requirements. This supports natural-language agent queries like 'find the Smith job on Queen Street' against a corpus of thousands of records. Lookup endpoints include /customers, /sites, and /jobs with consistent filtering semantics.

GET /customers?filterSearchText=Smith and return the top 5 matches with their associated sites

AI Agent Job Status Updates

Through Jentic, an agent can answer end-of-day questions like which jobs were finalised today and which quotes are awaiting customer acceptance. Jentic exposes Fergus's job, quote, and invoice operations as discoverable tools, letting a Claude or GPT agent generate daily summaries from natural-language requests. This removes the need for custom dashboards in small trades businesses.

Search Jentic for 'list jobs', filter by updatedAt for today, and return a markdown summary grouped by status

Key Endpoints

74 endpoints — the fergus api provides programmatic access to the fergus job management platform used by trades businesses such as plumbers and electricians.

METHOD

PATH

DESCRIPTION

GET

/jobs

List jobs

POST

/jobs

Create a job

PUT

/jobs/{jobId}/finalise

Finalise a job

GET

/jobs/{jobId}/phases

List job phases

GET

/favourites

List favourites

GET

/jobs

List jobs

POST

/jobs

Create a job

PUT

/jobs/{jobId}/finalise

Finalise a job

GET

/jobs/{jobId}/phases

List job phases

GET

/favourites

List favourites

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Fergus Personal Access Tokens and OAuth2 credentials are encrypted in the Jentic MAXsystem vault. Agents receive scoped access — the raw bearer token never enters the agent's context.

Intent-based discovery

Agents search by intent (e.g., 'create a job quote') and Jentic returns the matching Fergus operation and schema, so the agent can call POST /jobs/{jobId}/quotes without reading the developer docs.

Time to first call

Direct Fergus integration: 2-4 days for OAuth setup, rate-limit handling, and search semantics. Through Jentic: under 1 hour — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

FieldAware API

Field service management platform with similar jobs and customer surface

Choose FieldAware for larger field workforces; pick Fergus for SMB trades-focused workflows.

Complementary

Invoice Ninja API

Standalone invoicing platform that complements Fergus for accounting handoff

Use Invoice Ninja when the merchant has separate accounting and needs Fergus invoices mirrored elsewhere.

Complementary

Asana API

Task management to coordinate office work tied to Fergus jobs

Pair Asana with Fergus when office staff plan job preparation tasks separately from field execution.

FAQs

Specific to using Fergus API API through Jentic.

What authentication does the Fergus API use?

The Fergus API supports two methods: a Personal Access Token sent as a bearer token, and OAuth2 for delegated access. Through Jentic both methods are stored encrypted in MAXsystem and never enter agent context.

What are the rate limits for the Fergus API?

Fergus enforces 100 requests per minute per company, shared across all endpoints regardless of which token is used. Responses include x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset, and a retry-after header on 429s.

Can I finalise a job through the Fergus API?

Yes. Fergus exposes a dedicated PUT /jobs/{jobId}/finalise endpoint, separate from the generic update job call, so closing out a job is an explicit action with its own audit trail.

How do I create a quote for a job through Jentic?

Search Jentic for 'create job quote', load the POST /jobs/{jobId}/quotes schema, and execute with the line items. Run pip install jentic and from jentic import Jentic to get started.

Does the Fergus API support free-text search on lists?

Yes. Many list endpoints accept filterSearchText and filterSectionName query parameters with substring matching across searchable fields, so agents can find records without exact-match IDs.

Can the Fergus API track time logged against jobs?

Yes. The /time-entries endpoints let you list, retrieve, and create entries linked to specific jobs and users, supporting payroll and job profitability workflows.