For Agents
Schedule, optimise, and track last-mile delivery and service orders through Antsroute's 74 endpoints. Drives orders, agents, skills, customers, and route planning end-to-end.
Get started with Antsroute API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"create a delivery order in Antsroute"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Antsroute API API.
Create services, deliveries, and collect orders and place them on Antsroute's planning
Search availability slots and validate one before confirming a customer booking
Manage delivery agents along with their per-day hourly plans and skill sets
Reconcile order status using either Antsroute's internal ID or your own external reference
GET STARTED
Use for: I need to create a delivery order in Antsroute and schedule it for tomorrow, Find an available delivery slot for a customer in the next 3 days, List all routes assigned to a specific agent today, Update an order's scheduled date by external ID
Not supported: Does not handle payment collection, driver mobile-app UI, or warehouse inventory — use for delivery and service order scheduling, route planning, and agent management only.
Jentic publishes the only available OpenAPI document for Antsroute API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Antsroute API, keeping it validated and agent-ready. Antsroute is a last-mile route-optimisation platform whose API exposes 74 endpoints for managing services, deliveries and collects, agents and their hourly plans, customers and absences, item types, skills, packages, and route planning under the /capi namespace. Agents can create orders, place them on a planning, search availability slots, and reconcile order status by external ID, supporting both schedule-and-dispatch and bring-your-own-route workflows. Authentication uses an API key sent in the cakey header.
Maintain customer records including absences that block routing on certain dates
Configure item types, packages, and skills used by Antsroute's optimiser to assign work
Patterns agents use Antsroute API API for, with concrete tasks.
★ On-Demand Delivery Booking
Let a customer-facing app book a delivery slot by calling the availability search endpoint with the address and required skills, then confirming the chosen slot to insert the order onto the planning. Antsroute's optimiser handles agent assignment, sequencing, and ETA calculation server-side, so the booking flow only deals with slot selection and confirmation rather than full route maths.
Call the availability search endpoint for the customer's address, present the returned slots, then POST a service/delivery/collect order with the chosen slot
External-ID-Driven Order Sync
Synchronise orders between an upstream OMS or e-commerce platform and Antsroute by addressing each order via /capi/order/external-id/{externalId}. The agent can update, schedule, unschedule, or read status without storing Antsroute's internal IDs, which keeps the integration idempotent against retries and lets either side own the canonical reference.
Call GET /capi/order/external-id/{externalId} to read the current status, then PATCH the schedule via /capi/order/external-id/unschedule or /capi/order/id/{id}/schedule/{scheduledDate}
Agent and Skill Management
Manage the rota that drives the optimiser by maintaining agents, their hourly plans, and the skills required for specific order types. The agent endpoints let dispatchers add a new courier, set a custom hourly plan for a peak day, and attach skills like 'cold chain' or 'heavy goods' so the optimiser only assigns matching orders to that agent.
Call the agent skills endpoint to attach a 'cold chain' skill to a courier, then verify by reading /capi/agent/{agentEmail}/skills
AI Agent Dispatch Operations via Jentic
An AI agent embedded in a logistics ops console can drive Antsroute through Jentic without managing the cakey header directly. Jentic's intent search routes the agent to the correct /capi endpoint with its parameter schema, and the API key is loaded from the vault at execution time so it never enters the agent's tool context.
Search Jentic for 'create a delivery order in Antsroute', load the order-creation endpoint, and execute with the customer address, parcel size, and required skills
74 endpoints — jentic publishes the only available openapi specification for antsroute api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/capi/order/id/{id}
Retrieve an order by Antsroute internal ID
/capi/order/external-id/{externalId}
Retrieve an order by external reference
/capi/order/id/{id}/schedule/{scheduledDate}
Schedule an order for a specific date
/capi/order/unschedule
Unschedule a previously scheduled order
/capi/agent/{agentEmail}/skills
List skills assigned to an agent
/capi/agent/{agentEmail}/hourly-plans
Read an agent's hourly plan
/capi/customer/id/{id}
Retrieve a customer by ID
/capi/skill/{id}
Retrieve a skill definition
/capi/order/id/{id}
Retrieve an order by Antsroute internal ID
/capi/order/external-id/{externalId}
Retrieve an order by external reference
/capi/order/id/{id}/schedule/{scheduledDate}
Schedule an order for a specific date
/capi/order/unschedule
Unschedule a previously scheduled order
/capi/agent/{agentEmail}/skills
List skills assigned to an agent
Three things that make agents converge on Jentic-routed access.
Credential isolation
Antsroute cakey API keys are stored encrypted in the Jentic vault. Agents receive scoped execution access only — the cakey never enters the agent's prompt or tool context, which matters because the key authorises scheduling changes that affect live drivers.
Intent-based discovery
Agents search by intent (e.g., 'create a delivery order in Antsroute') and Jentic returns the matching /capi endpoint with its parameter schema, so the agent does not have to navigate Antsroute's 74-endpoint surface manually.
Time to first call
Direct Antsroute integration: 3-5 days to model orders, agents, skills, and the slot-search flow. Through Jentic: under 2 hours — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Routific API
Routific is a route-optimisation API that solves the same vehicle-routing problem as Antsroute.
Choose Routific when the agent needs a pure batch optimiser without Antsroute's planning, agent, and slot-management primitives.
Tookan API
Tookan is a delivery management platform with task creation, dispatch, and tracking endpoints.
Choose Tookan when the agent also needs an out-of-the-box driver mobile app and live tracking UI alongside dispatch.
Track-POD API
Track-POD covers route planning, ePOD, and driver app for last-mile fleets.
Choose Track-POD when proof-of-delivery capture and signature workflows are core to the use case.
Specific to using Antsroute API API through Jentic.
Why is there no official OpenAPI spec for Antsroute API?
Antsroute exposes a Swagger UI at app.antsroute.com/v3/api-docs/public for partners but does not publish a versioned downloadable OpenAPI specification. Jentic captures the live spec, validates it, and keeps it agent-ready. Get started at https://app.jentic.com/sign-up.
What authentication does the Antsroute API use?
Antsroute uses an API key sent in the cakey header on every request. The key is generated from your Antsroute account under your name menu in the dashboard. Through Jentic the cakey is stored in the encrypted vault and injected at execution time, so the raw key never enters the agent's prompt context.
Can I address Antsroute orders by my own external ID?
Yes. /capi/order/external-id/{externalId} mirrors the internal-ID endpoints so you can read, schedule, and unschedule orders without storing Antsroute's IDs. This keeps integrations idempotent against retries and lets the upstream OMS own the canonical reference.
What are the rate limits for the Antsroute API?
The OpenAPI spec does not declare explicit rate limits. Antsroute applies per-tenant throughput on the live service — back off on 429 responses and confirm your plan's ceiling with Antsroute before high-volume slot searches.
How do I create a delivery order in Antsroute through Jentic?
Run pip install jentic, then search Jentic for 'create a delivery order in Antsroute'. Jentic returns the matching service/delivery/collect creation endpoint with its schema. Execute with the customer address, parcel detail, and any required skills; the cakey is injected from the vault.
Does the Antsroute API support availability search before booking?
Yes. The 'Search availabilities and validate one in your planning' endpoint group lets the agent query open slots for an address and skill set, then confirm one of the returned slots to insert the order onto the planning.
/capi/agent/{agentEmail}/hourly-plans
Read an agent's hourly plan
/capi/customer/id/{id}
Retrieve a customer by ID
/capi/skill/{id}
Retrieve a skill definition