How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Nash Job API is one of 30 APIs that Nash publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Job. The published artifact set on APIs.io includes an OpenAPI specification, authentication docs, an AsyncAPI specification, and rate-limit docs.

This API exposes 19 operations across 16 paths, and defines 59 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 4 base URLs: https://api.sandbox.usenash.com, https://api.sandbox.ap-southeast-2.usenash.com, https://api.usenash.com, https://api.ap-southeast-2.usenash.com.

19 operations 16 paths 59 schemas 5 GET1 PATCH13 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.usenash.com/v1
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Nash Job API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT, API Key) (Token).

Paths & Operations 19

Across 16 paths, the API surfaces 19 operations — 5 GET, 1 PATCH, 13 POST. Each is listed below with its method, path, parameters, and response codes.

Job 19

Job

GET
/v1/jobs
List/Search Jobs
list_jobs_v1_jobs_get 21 params → 200422
POST
/v1/jobs
Create Job
create_job_v1_jobs_post body → 200422
GET
/v1/jobs/external_identifier/{externalIdentifier}
Get Job by External Identifier
get_job_by_external_id_v1_jobs_external_identifier__string_externalIdentifier__get 1 param → 200422
POST
/v1/jobs/external_identifier/{externalIdentifier}
Create or Update Job by External Identifier
create_or_update_job_by_external_id_v1_jobs_external_identifier__string_externalIdentifier__post 1 param body → 200422
POST
/v1/jobs/external_identifier/{externalIdentifier}/autodispatch
Autodispatch job by external identifier
autodispatch_job_by_external_id_v1_jobs_external_identifier__string_externalIdentifier__autodispatch_post 1 param → 200422
POST
/v1/jobs/external_identifier/{externalIdentifier}/cancel
Cancel Job by External Identifier
_cancel_job_by_external_identifier_v1_jobs_external_identifier__string_externalIdentifier__cancel_post 1 param → 200422
GET
/v1/jobs/{id}
Get Job
get_job_v1_jobs__string_id__get 2 params → 200422
PATCH
/v1/jobs/{id}
Update Job by JobID/ExternalIdentifier
update_job_v1_jobs__string_id__patch 2 params body → 200422
POST
/v1/jobs/{id}/autodispatch
Autodispatch job
autodispatch_job_v1_jobs__string_id__autodispatch_post 1 param → 200422
POST
/v1/jobs/{id}/rebook
Rebook Job
rebook_job_v1_jobs__string_id__rebook_post 2 params body → 200422
POST
/v1/jobs/{id}/refresh
Refresh job
refresh_job_v1_jobs__string_id__refresh_post 1 param → 200422
POST
/v1/jobs/{jobId}/cancel
Cancel Job by Job ID
cancel_job_v1_jobs__string_jobId__cancel_post 2 params → 200422
POST
/v1/jobs/{jobId}/tasks/{taskId}/delivery_incident
Create delivery incident
delivery_incident_v1_jobs__string_jobId__tasks__string_taskId__delivery_incident_post 2 params body → 200422
POST
/v1/jobs/{jobId}/tasks/{taskId}/quotes
Select Quote by Job ID and Task ID
select_quote_task_v1_jobs__string_jobId__tasks__string_taskId__quotes_post 2 params body → 200422
POST
/v1/jobs/{jobId}/tasks/{taskId}/refresh_quotes
Refresh Quotes by Job ID and Task ID
refresh_quotes_task_v1_jobs__string_jobId__tasks__string_taskId__refresh_quotes_post 2 params → 200422
POST
/v1/jobs/{jobId}/{taskId}/reassign
Reassign task by Job ID and Task ID
reassign_task_v1_jobs__string_jobId___string_taskId__reassign_post 2 params body → 200422
GET
/v1/refund-request/{id}
Get Refund Request
get_refund_request_v1_refund_request__string_id__get 1 param → 200422
GET
/v1/refund-requests
Get Refund Requests by Task ID or Job ID
get_refund_requests_v1_refund_requests_get 2 params → 200422
POST
/v1/select_quote
Select Quote
select_quote_v1_select_quote_post body → 200422

Schemas 59

The contract defines 59 schemas that model the data the API accepts and returns. The most detailed are CreateJobInputSerializerAndAutodispatch (55 properties), CreateJobInputSerializer (54 properties), UpdateJobInputSerializer (39 properties), DeliverySerializer (34 properties). Each schema is shown below with its type and property counts.

QuoteSerializer
object
Generic serializer for quotes used in many endpoints.
25 properties 5 required
TaskSerializer
object
Generic serializer for tasks used in many endpoints.
17 properties 3 required
SelectQuoteOutputSerializer
object
Expected output when selecting a quote for a task, batch , order.
1 property 1 required
DeliveryIncidentOutputSerializer
object
12 properties 8 required
JobLocationSummary
object
7 properties
BarcodeInfoSerializer
object
Serializer for barcode information in scans.
15 properties
StopOrderSerializer
object
Order information associated with a route stop.
5 properties 1 required
UpdateJobInputSerializer
object
Expected input for update job endpoint.
39 properties
DriverGroupSerializer
object
Driver group details for a route.
2 properties
NashValidationError
object
3 properties 3 required
ProofOfDeliverySerializer
object
Delivery tracking details for an order at a route stop.
3 properties 1 required
SubstitutionObject
object
3 properties
SelectTaskQuoteOutputSerializer
object
Expected output when selecting a quote.
5 properties 2 required
DeliveryIncidentInputSerializer
object
9 properties 2 required
BatchSerializer
object
Generic serializer for batches used in many endpoints.
9 properties 5 required
BasicUserSerializer
object
Generic serializer for basic users used in many endpoints.
1 property 1 required
BatchStopTypes
string
Various stop types for batch and route object.
FullJobPayload
object
Expected output from autodispatch job endpoint.
1 property 1 required
ReturnedJobMixin
object
A Nash Job.
13 properties 6 required
SelectQuoteInputSerializer
object
Expected input for selecting a quote.
1 property 1 required
VehicleSerializer
object
Vehicle details for a route.
6 properties
RefundStatus
integer
DeliverySerializer
object
Generic serializer for deliveries used in many endpoints. Some endpoints won't return all fields, so they are optional. This means that they will return field…
34 properties 5 required
ItemStatusHistoryEntrySerializer
object
A single status change entry in an item's status history.
2 properties 2 required
JobConfigurationsSerializer
object
Generic serializer for jbo configurations used in many endpoints.
6 properties 3 required
LatLngSerializer
object
Latitude/longitude coordinates.
2 properties 2 required
ParsedAddressInputSerializer
object
Parsed address input serializer for creating a job.
10 properties 3 required
RefundRequestResponse
object
Response for refund request.
20 properties 19 required
RefreshQuotesOutputSerializer
object
Expected output for refreshing quotes.
2 properties 2 required
JobListItem
object
11 properties 1 required
CompressedAdvancedTaskSerializer
object
Generic serializer for tasks used in many endpoints.
1 property 1 required
CourierSerializer
object
Courier details for a route.
4 properties
Dimensions
object
3 properties
ListRefundRequestResponse
array
Expected output for listing refund requests.
OrderItemSerializer
object
Item with status tracking for route stop webhook payloads. Combines item definition with lifecycle status from the route state machine.
12 properties
NashErrorDetails
object
3 properties 2 required
ItemScanSerializer
object
Serializer for individual item scans.
2 properties
CourierPositionSerializer
object
Current GPS position of a courier.
12 properties 2 required
JobDeliverySummary
object
7 properties
DocumentSerializer
object
Generic serializer for Nash documents; Used for output.
7 properties 4 required
LocationSerializer
object
Generic serializer for location used in many endpoints.
20 properties 7 required
ReassignTaskInputSerializer
object
Body for reassign task endpoint.
5 properties
ItemOutput
object
Item object returned by the API.
11 properties
RouteStopSerializer
object
Represents a single stop within a planned route.
16 properties 3 required
NoteSerializer
object
Generic serializer for notes used in many endpoints.
4 properties 4 required
RebookJobBody
object
Body for rebook job endpoint.
4 properties
PickedItemsSerializer
object
Generic serializer for picked items; Used for output.
12 properties
ItemStatusMetadataSerializer
object
Operational metadata tracked during item lifecycle in route delivery.
6 properties
PackageSerializer
object
Generic serializer for packages used in many endpoints; Used for output.
32 properties 6 required
CreateJobInputSerializerAndAutodispatch
object
Expected payload for creating a job and optionally autodispatch.
55 properties 1 required
JobsListResponse
object
4 properties 4 required
ReturnedBatchJobMixin
object
The format for a returned batch job used in many endpoints.
12 properties 8 required
RefundRequestType
string
CreateJobInputSerializer
object
Expected payload for creating a job.
54 properties 1 required
SubstituteItemObject
object
3 properties
SubItemOutput
object
Sub-item object returned by the API.
13 properties
RouteSerializer
object
Represents a planned sequence of stops for a delivery or batch.
21 properties 4 required
PackageRequirements
string
Detailed description: https://docs.usenash.com/reference/package-requirements.
OptionsGroupSerializer
object
Generic serializer for options groups used in many endpoints.
12 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

nash-job-api-openapi.yml Raw ↑

Other APIs Nash publishes across the network.

Nash AI Functions API
Nash Annotate API
Nash Batch Job API
Nash Contracts API
Nash Couriers API
Nash Delivery Windows API
Nash Dispatch Strategies API
Nash Feedback API
Nash Fleet API
Nash Messaging API
Nash Miscellaneous API
Nash Notifications API
Where this information came from

This is an independent, third-party profile of Nash Job API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.