# OneRail

> OneRail is a last-mile delivery orchestration platform (OmniPoint) for enterprise shippers. It rate-shops
> and dispatches orders across a network of 1,000+ connected carriers and 12M+ drivers, optimizes multi-stop
> routes for internal fleets, and streams delivery events back to the shipper for end-to-end visibility and
> proof of delivery. Two REST APIs are documented publicly: the Delivery API (orders, rates, deliveries,
> labels, routes, visibility) and the Operations API (organizations, locations, users, carriers, contracts,
> SLAs, fleet, credentials).

Generated by the API Evangelist enrichment pipeline on 2026-08-02 from OneRail's own public surface.
Method: generated. Source: https://developer.onerail.io/hc/en-us

## Authentication

Organization API key pair sent on every request as two headers: `X-ONERAIL-APP-ID` and `X-ONERAIL-API-KEY`.
Credentials are minted per shipper organization by the OneRail product/customer success team
(support@onerail.io); there is no self-serve signup. A user-token flow (`POST /user/authenticate`), a JWT
bearer scheme, a customer-IdP OAuth 2.0 scheme, and a client-credentials exchange (`POST /oauth2/token`)
also exist.

## APIs

- [OneRail Delivery API](https://developer.onerail.io/hc/en-us/articles/50724541394971-Getting-Started-with-Delivery-API): OpenAPI 3.0.1, 31 operations. Base host https://onerail-delivery-api-prod.azurewebsites.net
- [OneRail Operations API](https://developer.onerail.io/hc/en-us/articles/53169025821339-CapacityConnect-API-Quickstart-Guide): OpenAPI 3.0.1, 438 operations. Base host https://onerail-operations-prod.azurewebsites.net

## Specs

- [Delivery API OpenAPI](https://raw.githubusercontent.com/api-evangelist/onerail/refs/heads/main/openapi/onerail-delivery-api-openapi.yml): harvested from https://onerail-delivery-api-prod.azurewebsites.net/api-docs/swagger-ui-init.js
- [Operations API OpenAPI](https://raw.githubusercontent.com/api-evangelist/onerail/refs/heads/main/openapi/onerail-operations-api-openapi.yml): harvested from https://onerail-operations-prod.azurewebsites.net/api-docs/swagger-ui-init.js

## Key operations

- `POST /delivery/check-availability` (checkDeliveryAvailability): is this lane servable, and at roughly what price
- `POST /delivery/get-rates` (getDeliveryRates): rate shop every qualified carrier; optionally save a draft
- `POST /order/create` (create) and `POST /v2/order` (createV2): create an order and its deliveries
- `PATCH /order/{orderId}/partial-update` (patchPartialUpdate): progressively fill in carrier, costs, labels
- `POST /delivery/{id}/cancel` (cancelDelivery): cancel with a reason
- `GET /delivery/{id}/details` (getDetails): authoritative delivery state
- `POST /v1/routes` (createRoutes): multi-stop routing, `skipOptimizer` controls resequencing
- `POST /visibility/create` (createVisibility): tracking-only shipment fulfilled outside the OneRail network
- `PATCH /v1/organization/{organizationId}/webhook-url` (updateWebhookUrl, Operations API): register the event endpoint

## Events

Delivery status changes are pushed to a shipper-registered webhook endpoint. Event types:
ACCEPTED_BY_LP, DRIVER_ASSIGNED, EN_ROUTE_TO_PICKUP, ARRIVED_FOR_PICKUP, PICKED_UP, EN_ROUTE_TO_DELIVERY,
ARRIVED_FOR_DELIVERY, DELIVERED (carries podUrl + signature), CANCELED_BY_ONERAIL, CANCELED_BY_SHIPPER,
NO_MATCHING_SLA_SHIPPER_CONTRACTS. Visibility deliveries additionally emit GEO.
No AsyncAPI document is published and no webhook signing scheme is documented.

## Docs

- [Developer Hub](https://developer.onerail.io/hc/en-us)
- [Getting Started with Delivery API](https://developer.onerail.io/hc/en-us/articles/50724541394971-Getting-Started-with-Delivery-API)
- [CapacityConnect API Quickstart](https://developer.onerail.io/hc/en-us/articles/53169025821339-CapacityConnect-API-Quickstart-Guide)
- [Delivery Events and Webhooks](https://developer.onerail.io/hc/en-us/articles/50726344844315-Delivery-Events-and-Webhooks)
- [Understanding Routing](https://developer.onerail.io/hc/en-us/articles/50726402639131-Understanding-Routing)
- [Understanding Visibility](https://developer.onerail.io/hc/en-us/articles/50726392463259-Understanding-Visibility)
- [Understanding Partial Updates and Get Rates](https://developer.onerail.io/hc/en-us/articles/50726320529051-Understanding-Partial-Updates-and-Get-Rates)
- [Knowledge Hub](https://knowledge.onerail.io/hc/en-us)
- [Platform Status](https://onerail.cronitorstatus.com)
- [Trust Center](https://trust.onerail.com/)

## Artifacts

- [Authentication](https://raw.githubusercontent.com/api-evangelist/onerail/refs/heads/main/authentication/onerail-authentication.yml)
- [Conventions](https://raw.githubusercontent.com/api-evangelist/onerail/refs/heads/main/conventions/onerail-conventions.yml)
- [Error catalog](https://raw.githubusercontent.com/api-evangelist/onerail/refs/heads/main/errors/onerail-problem-types.yml)
- [Lifecycle](https://raw.githubusercontent.com/api-evangelist/onerail/refs/heads/main/lifecycle/onerail-lifecycle.yml)
- [Data model](https://raw.githubusercontent.com/api-evangelist/onerail/refs/heads/main/data-model/onerail-data-model.yml)
- [Webhook event catalog](https://raw.githubusercontent.com/api-evangelist/onerail/refs/heads/main/asyncapi/onerail-delivery-events-webhooks.yml)
- [Sandbox / environments](https://raw.githubusercontent.com/api-evangelist/onerail/refs/heads/main/sandbox/onerail-sandbox.yml)
- [Agent skills](https://raw.githubusercontent.com/api-evangelist/onerail/refs/heads/main/skills/_index.yml)

## Not published

No llms.txt, no /.well-known documents (security.txt, openid-configuration, api-catalog, agent-card.json),
no A2A agent card, no MCP server, no GraphQL endpoint, no first-party SDKs on npm/PyPI/NuGet/RubyGems/
crates.io/Maven, no CLI, no public Postman workspace, no GitHub organization, no public changelog,
no published rate limits, and no vulnerability-disclosure program.