Status Update Webhook

The payload schema for our status update webhook can be found below

Gophr is able to notify you when a delivery transitions from one status to another by sending a webhook to a URL of your choice. Webhooks are sent when a job changes to any of the following statuses:

ACCEPTED_BY_COURIER
AT_PICKUP
EN_ROUTE
AT_DELIVERY
TAKING_SIGNATURE
DELIVERED
CANCELED_BY_CUSTOMER

Status update webhooks contain the following data:

Delivery ETA's
Courier details
Courier location (latitude and longitude)
New delivery status
Price of the job (useful if the job is a return leg)
Delivery pickup / dropoff proof
Any details relating to a linked delivery

Linked Deliveries

Linked deliveries are deliveries that are automatically generated by Gophr. If an existing delivery has a linked delivery associated with it, we will include this using the linked_delivery field in the webhook payload.

Example payload Schema: Status

{
  "delivery_id": "0dd41eb9-564d-4b5d-8acc-05b4cd8e0ae2",
  "external_id": "gophr-64a53d967f54d",
  "pickup_eta": "2023-07-03T10:57:16+01:00",
  "delivery_eta": "2023-07-03T11:09:28+01:00",
  "courier_location_lat": "51.50700000",
  "courier_location_lng": "-0.10500000",
  "status": "AT_DELIVERY",
  "leg_type": null,
  "price_net": {
    "amount": 11.91,
    "currency": "GBP"
  },
  "price_gross": {
    "amount": 14.29,
    "currency": "GBP"
  },
  "meta_data": [
  ],
  "courier_name": "dCourier",
  "courier_notes": null,
  "courier_mobile_number": "+447777777777",
  "cancellation_comment": null,
  "proof_of_pickup": [],
  "proof_of_delivery": [],
  "events": [
    {
      "timestamp": 1688547206,
      "status": "CONFIRMED_BY_CUSTOMER"
    },
    {
      "timestamp": 1688547419,
      "status": "ACCEPTED_BY_COURIER"
    },
    {
      "timestamp": 1688547436,
      "status": "AT_PICKUP"
    },
    {
      "timestamp": 1688547447,
      "status": "EN_ROUTE"
    },
    {
      "timestamp": 1688548168,
      "status": "AT_DELIVERY"
    }
  ],
  "linked_delivery": null
}

{
  "job_id": "b8f0c1a2-3d4e-4f56-a7b8-9c0d1e2f3a4b",
  "delivery_id": "0dd41eb9-564d-4b5d-8acc-05b4cd8e0ae2",
  "external_id": "gophr-64a53d967f54d",
  "pickup_eta": "2023-07-03T10:57:16+01:00",
  "delivery_eta": "2023-07-03T11:09:28+01:00",
  "courier_location_lat": "51.50700000",
  "courier_location_lng": "-0.10500000",
  "status": "DELIVERED",
  "leg_type": null,
  "price_net": {
    "amount": 11.91,
    "currency": "GBP"
  },
  "price_gross": {
    "amount": 14.29,
    "currency": "GBP"
  },
  "meta_data": [],
  "courier_name": "dCourier",
  "courier_notes": null,
  "courier_mobile_number": "+447777777777",
  "cancellation_comment": null,
  "proof_of_pickup": [],
  "proof_of_delivery": [],
  "events": [
    {
      "timestamp": 1688547206,
      "status": "CONFIRMED_BY_CUSTOMER"
    },
    {
      "timestamp": 1688547419,
      "status": "ACCEPTED_BY_COURIER"
    },
    {
      "timestamp": 1688547436,
      "status": "AT_PICKUP"
    },
    {
      "timestamp": 1688547447,
      "status": "EN_ROUTE"
    },
    {
      "timestamp": 1688548168,
      "status": "AT_DELIVERY"
    },
    {
      "timestamp": 1688548302,
      "status": "DELIVERED"
    }
  ],
  "linked_delivery": {
    "delivery_id": "7f3c9a21-8e4b-4c1a-9d6f-2b5e0a7c4d18",
    "external_id": "gophr-64a53d967f54d-return",
    "pickup_eta": "2023-07-03T11:20:00+01:00",
    "delivery_eta": "2023-07-03T11:52:00+01:00",
    "courier_location_lat": "51.51300000",
    "courier_location_lng": "-0.09800000",
    "status": "ACCEPTED_BY_COURIER",
    "leg_type": "RETURN",
    "price_net": {
      "amount": 9.50,
      "currency": "GBP"
    },
    "price_gross": {
      "amount": 11.40,
      "currency": "GBP"
    },
    "meta_data": [],
    "courier_name": "dCourier",
    "courier_notes": null,
    "courier_mobile_number": "+447777777777",
    "cancellation_comment": null,
    "proof_of_pickup": [],
    "proof_of_delivery": [],
    "events": [
      {
        "timestamp": 1688548360,
        "status": "CONFIRMED_BY_CUSTOMER"
      },
      {
        "timestamp": 1688548515,
        "status": "ACCEPTED_BY_COURIER"
      }
    ]
  }
}

{
  "delivery_id": "0dd41eb9-564d-4b5d-8acc-05b4cd8e0ae2",
  "external_id": "gophr-64a53d967f54d",
  "pickup_eta": "2023-07-03T10:57:16+01:00",
  "delivery_eta": "2023-07-03T11:09:28+01:00",
  "courier_location_lat": "51.50700000",
  "courier_location_lng": "-0.10500000",
  "status": "DELIVERED",
  "leg_type": null,
  "price_net": {
    "amount": 11.91,
    "currency": "GBP"
  },
  "price_gross": {
    "amount": 14.29,
    "currency": "GBP"
  },
  "meta_data": [
  ],
  "courier_name": "dCourier",
  "courier_notes": null,
  "courier_mobile_number": "+447777777777",
  "cancellation_comment": null,
  "proof_of_pickup": [
    {
      "id": "14708528",
      "url": "https://storage.googleapis.com/gophr-prod-uploads-eu/uploads/proof-of-pickup/2026/07/07/095043-08678881431082098044.jpg?GoogleAccessId=gophr-prod%40appspot.gserviceaccount.com&Expires=1783759844&Signature=X0WPrT2T%2B3ePzMqZV6scnsRC0s2S4bUuYFTHN5424%2FP7Swtoo5v1vJYu%2BGP5JEt9XX9HOUM%2BqVu7t4sE6gPtPEa3qWXGCgrEgFusE2f3F1M1f9nnb4XtBsTvk0la7QL3%2BxyrOINOHUAqbEfI%2B7gzuZpNH%2B4n4JW5c8QriosxE3rG397sBtXvkYdOfCnbUDFxo7HjZYheuBdUTF7FHmFpf7TIg9NgnSDFcHIBdiwNsC%2FppM%2Fer3sFGEwGiNF1y%2FMkATfFKPnyrQ1XSerMYEX5FRF1NxK77QmkTqV57LZLYAhvjo8UH2T07oixp3Rrjpcdq70yHm87X%2FmUNBOVAcosAg%3D%3D",
      "type": "photo"
    }
  ],
  "proof_of_delivery": [
    {
      "id": "10852228",
      "url": "https://storage.googleapis.com/gophr-prod-uploads-eu/uploads/proof-of-delivery/2026/07/07/095043-08678881431082098044.jpg?GoogleAccessId=gophr-prod%40appspot.gserviceaccount.com&Expires=1783759844&Signature=X0WPrT2T%2B3ePsds6scnsRC0s2S4bUuYFTHN5424%2FP7Swtoo5v1vJYu%2BGP5JEt9XX9HOUM%2BqVu7t4sE6gPtPEa3qWXGCgrEgFusE2f3F1M1f9nnb4XtBsTvk0la7QL3%2BxyrOINOHUAqbEfI%2B7gzuZpNH%2B4n4JW5c8QriosxE3rG397sBtXvkYdOfCnbUDFxo7HjZYheuBdUTF7FHmFpf7TIg9NgnSDFcHIBdiwNsC%2FppM%2Fer3sFGEwGiNF1y%2FMkATfFKPnyrQ1XSerMYEX5FRF1NxK77QmkTqV57LZLYAhvjo8UH2T07oixp3Rrjpcdq70yHm87X%2FmUNBOVAcosAg%3D%3D",
      "type": "photo"
    },
    {
      "id": "15678528",
      "url": "https://storage.googleapis.com/gophr-prod-uploads-eu/uploads/proof-of-delivery/2026/07/07/095043-08678881431082098044.jpg?GoogleAccessId=gophr-prod%40appspot.gserviceaccount.com&Expires=1783759844&Signature=X0WPrT2T%2B3ePzMqZergegs2S4bUuYFTHN5424%2FP7Swtoo5v1vJYu%2BGP5JEt9XX9HOUM%2BqVu7t4sE6gPtPEa3qWXGCgrEgFusE2f3F1M1f9nnb4XtBsTvk0la7QL3%2BxyrOINOHUAqbEfI%2B7gzuZpNH%2B4n4JW5c8QriosxE3rG397sBtXvkYdOfCnbUDFxo7HjZYheuBdUTF7FHmFpf7TIg9NgnSDFcHIBdiwNsC%2FppM%2Fer3sFGEwGiNF1y%2FMkATfFKPnyrQ1XSerMYEX5FRF1NxK77QmkTqV57LZLYAhvjo8UH2T07oixp3Rrjpcdq70yHm87X%2FmUNBOVAcosAg%3D%3D",
      "type": "signature"
    }
  ],
  "events": [
    {
      "timestamp": 1688547206,
      "status": "CONFIRMED_BY_CUSTOMER"
    },
    {
      "timestamp": 1688547419,
      "status": "ACCEPTED_BY_COURIER"
    },
    {
      "timestamp": 1688547436,
      "status": "AT_PICKUP"
    },
    {
      "timestamp": 1688547447,
      "status": "EN_ROUTE"
    },
    {
      "timestamp": 1688548168,
      "status": "AT_DELIVERY"
    }
  ],
  "linked_delivery": null
}