Cancel a delivery

POST

/orders/{external_order_id}/cancel

curl --request POST \
  --url https://api.govza.app/v1/partner/orders/example/cancel \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "reason": "example", "comment": "example" }'

Authorizations

• apiKey

Parameters

Path Parameters

external_order_id

required

string

<= 128 characters

Your own identifier for the order.

Request Body

Media typeapplication/json

object

reason

string

<= 255 characters

comment

string

<= 2000 characters

Example^generated

{
  "reason": "example",
  "comment": "example"
}

Responses

200

The delivery was cancelled.

Media typeapplication/json

object

success

boolean

data

object

external_order_id

string

order_code

The human-readable Govza order code.

string

status

string

Allowed values: new assigned in_progress delivered cancelled

price

number

nullable

tracking_url

Public tracking page, safe to forward to the recipient.

string

nullable

tracking_urls

Individual tracking pages in dropoff order. Null for a single-dropoff order or when unavailable.

Array<string>

nullable

Example

{
  "data": {
    "status": "new"
  }
}

401

The key is missing, malformed, revoked, or its account can no longer create orders.

Media typeapplication/json

object

success

boolean

error

object

id

string

code

string

message

string

details

string

Example

{
  "success": false
}

404

No order exists for this external_order_id.

Media typeapplication/json

object

success

boolean

error

object

id

string

code

string

message

string

details

string

Example

{
  "success": false
}