canonical: https://jentic.com/apis/manager.alphatracker.co.uk/alphatracker

# Manager Alphatracker Alpha Tracker API

The Alpha Tracker API drives the Alpha Tracker asbestos management software, letting an application create and search survey projects, sites, and buildings and track their work through to completion. It records samples and survey items against a project, retrieves quotations and repair instructions, schedules and updates appointments, lists staff, and runs saved reports by category. It also downloads project files and sends re-inspection data to a surveyor's handset.

## For AI agents

Create and search asbestos survey projects, sites, and buildings, record samples and survey items, schedule appointments, run saved reports, and download project files. Built for the Alpha Tracker surveying workflow.

## Scope

Does not handle accounting, payroll, or laboratory analysis. Use for managing asbestos survey projects, sites, samples, appointments, and reports only.

## Capabilities

- Create and search survey projects by criteria
- Register sites and the buildings that belong to them
- Record samples and survey items against a project
- Schedule, update, and cancel project appointments
- Run saved reports by category and download project files
- Retrieve quotations and repair instructions
- Send re-inspection data to a surveyor's handset

## Use cases

### Agent-managed survey intake

An AI agent handling inbound survey requests creates a project, registers the site and its buildings, and schedules the first appointment, all against the Alpha Tracker API. Because the API exposes project, site, building, and appointment operations, the agent can take a job from enquiry to a booked survey. Through Jentic the agent discovers each operation by intent and the two required headers are supplied at call time.

Example prompt: Create a project, register its site and building, and schedule the first appointment for the survey

### Sample and survey-item capture

Surveyors on site record the samples they collect and the items they inspect. The Alpha Tracker API accepts samples and survey items against a specific project number and returns the list back, so a mobile workflow can push field data into the central system and read it back for reporting without manual re-entry.

Example prompt: Record the samples collected on a project and then list the project's survey items to confirm they were saved

### Report generation and file retrieval

Once fieldwork is done, a team needs the certificates and reports for a project. The Alpha Tracker API lists reports by category, runs a named report, and downloads project files including the bulk certificate, so an agent can assemble a client's deliverables from the stored project data.

Example prompt: List the reports in a category, run the required report for a project, and download the resulting certificate file

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/projects` | Create a project |
| GET | `/projects/search` | Search projects by criteria |
| POST | `/sites` | Create a site |
| POST | `/samples/{projectNumber}` | Record samples for a project |
| POST | `/appointments/{projectNumber}` | Create an appointment for a project |
| POST | `/reports/{category}/{reportName}` | Run a saved report |

## Key resources

- **Projects** — Create, update, search, and delete survey projects and list their milestones
- **Sites and Buildings** — Create sites, add buildings to a site or project, and read them back
- **Samples and Survey Items** — Record samples against a project and list its survey items
- **Appointments** — Create, update, and cancel appointments for a project
- **Reports and Files** — List and run saved reports and download project files and certificates

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 54 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 85 / 100
  - Developer Experience & Jentic Compatibility: 63 / 100
  - AI-Readiness & Agent Experience: 31 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 63 / 100
- **View full report:** https://jentic.com/apis/manager.alphatracker.co.uk/alphatracker/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the Alpha Tracker API by hand means sending the right two headers on every call, learning the project-number and site-id path structure, and parsing report and file downloads yourself. Through Jentic you install once, import it from the API Directory, store the api key and client id once, and your agent calls it.
- **Permission scoping:** Alpha Tracker puts the project number and site id in the URL path, so a rule can pin your agent to specific projects and the operations you pick. You choose the operation set, so the delete operations on projects and sites are not included unless you add them.
- **Credential handling:** Your Alpha Tracker api key and client id are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'create a survey project' or 'run a report', and Jentic returns the matching Alpha Tracker operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Asana** — Asana tracks generic projects and tasks, where Alpha Tracker models the asbestos surveying workflow.
- **Trello** — Trello manages boards and cards for lightweight project tracking.
- **monday.com** — monday.com coordinates team workflows that can sit alongside Alpha Tracker's survey records.

## FAQ

### What authentication does the Alpha Tracker API use?

The Alpha Tracker API expects two headers on each call, per its OpenAPI spec: an api key in the x-api-key header and a client identifier in the client-id header, both issued by Alpha Tracker support. Through Jentic both values are stored once and injected at call time, so they never enter the agent's prompt, logs, or context.

### Can I run reports and download certificates with the Alpha Tracker API?

Yes. The API lists the saved reports in a category, runs a named report for a project, and downloads project files including the bulk certificate. An agent can list the reports available, run the one it needs, and fetch the resulting file for a client's project.

### What are the rate limits for the Alpha Tracker API?

The OpenAPI spec does not define numeric rate limits. Have your agent back off when it receives an HTTP 429 response, and contact Alpha Tracker support for the current limits that apply to your client id.

### Is there an Alpha Tracker MCP server?

You don't need an MCP server to give your agent the Alpha Tracker API. Jentic connects it directly from the API Directory: import it, store your api key and client id once, and your agent calls it. Operations are discovered on demand, so no extra tool definitions sit in the agent's context.

### Can I limit what my agent is allowed to do with the Alpha Tracker API?

Yes. Alpha Tracker puts the project number and site id in the URL path, such as the project and site operations, so a rule can pin your agent to the projects and the operations you pick, letting it create samples and run reports without the delete operations unless you add them. Every call it makes is logged.

### How do I create a survey project through Jentic?

Search Jentic for an intent such as 'create a new survey project' and it returns the matching project operation with its input schema, so your agent posts the project details and reads back the project number. To run it on your own infrastructure, install Jentic One from its GitHub repo.