# Errors

{% hint style="warning" %}
NOTE: We only guarantee that the errorType will not change. The corresponding message or optional data may change in the future.
{% endhint %}

<table><thead><tr><th width="263.12890625">Error type</th><th width="479.3359375">Description</th></tr></thead><tbody><tr><td><code>VALIDATION_ERROR</code></td><td>The body/query has missing fields and/or using incorrect types.</td></tr><tr><td><code>ADDRESS_NOT_FOUND</code></td><td>Google was unable to resolve the address.</td></tr><tr><td><code>PARTIAL_ADDRESS</code></td><td>Google found multiple matches for the address provided - please provide more information.</td></tr><tr><td><code>PRICE_ESTIMATE_UNAVAILABLE</code></td><td>We were unable to calculate a price estimate, typically due to addresses far away from transport hubs. Contact Gire support for a quote.</td></tr><tr><td><code>CANNOT_CANCEL_PUD</code></td><td>The PUD cannot be cancelled, likely due to it already be in progress.</td></tr><tr><td><code>BOOKING_BLOCKED</code></td><td>The PUD cannot be accepted due to a booking block during the specified hours (can happen in periods of insufficient driver capacity).</td></tr><tr><td><code>INVALID_BOOKING_INTERVAL</code></td><td>The interval provided is invalid. </td></tr><tr><td><code>BOOKING_BAN</code></td><td>Your account is temporarily suspended, likely due to outstanding bills. Contact support for more information.</td></tr></tbody></table>

{% hint style="info" %}
If the error is not one specified in the list above, the errorType will simply be an error code matching the status code. 404 -> NOT\_FOUND, for example.
{% endhint %}

Example error responses:

```
{
    errorType: "CANNOT_CANCEL_PUD",
    statusCode: 409,
    message: "This PUD cannot be cancelled because it is already in progress",
    path: "/api/v3/puds",
    timestamp: "2025-05-14T13:50:26.480Z",
    requestId: "fdd33be0-78e1-4ade-8d01-10e15f807510"
}
```

```
{
    errorType: "BOOKING_BLOCKED",
    statusCode: 409,
    message: "We are unable to accept the booking due to insufficient driver capacity.",
    path: "/api/v3/puds",
    timestamp: "2025-05-14T13:50:26.480Z",
    requestId: "fdd33be0-78e1-4ade-8d01-10e15f807510"
}
```

If the error is not one specified in the list above, the errorType will simply be an error code matching the status code. 404 -> NOT\_FOUND, for example.