# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://giremobility.gitbook.io/api/v3/errors.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.