# Report a no-show or a delay

> Report a traveller no-show or a driver who left the pickup, with photo evidence.

Section: Transfer companies · Last updated: 2026-11-15

You will report that a traveller did not show up, attach evidence such as a photo of the empty
meeting point, and close the journey. You need an API key and a journey assigned to your company.
Reports like this are called actions.

## Which actions you can report

| Type                                 | Use when                                     | Accepted by the API |
| ------------------------------------ | -------------------------------------------- | ------------------- |
| `TRAVELLER_NO_SHOW`                  | The traveller did not show up at the pickup. | Yes                 |
| `DRIVER_LEFT_PICKUP`                 | The driver left the pickup location.         | Yes                 |
| `DRIVER_DELAYED`                     | The driver is late.                          | No                  |
| `ADDITIONAL_PROOF_TRAVELLER_NO_SHOW` | Extra evidence for a no-show.                | No                  |

The two types the API does not accept are set by other Transferz systems. To add more evidence to a
no-show, upload another attachment to the same action instead.

> **To be confirmed by Transferz:** How a transfer company should report a delayed driver through the API, now that `DRIVER_DELAYED` is
> refused, is still to be confirmed by Transferz.

> **To be confirmed by Transferz:** The exact meaning of `DRIVER_LEFT_PICKUP` is still to be confirmed by Transferz.

## Step 1: Report the stages first

A no-show is easiest to prove when the journey shows the driver on the way and at the pickup. Send
[driver underway](https://developers.test.transferz.com/reference/transfer-companies/set-driver-underway) and
[driver arrived](https://developers.test.transferz.com/reference/transfer-companies/set-driver-arrived), each with the driver's position,
as described in [Report journey progress](https://developers.test.transferz.com/guides/transfer-companies/report-journey-progress).
Transferz looks for both, with positions, plus a no-show action with at least one attachment.

## Step 2: Create the no-show action

Send the journey id, the type and the driver's position where the no-show happened:

**Request:** [`POST /actions`](https://developers.test.transferz.com/reference/transfer-companies/create-action)

```bash title="cURL"
curl --request POST \
  --url 'https://warpdrive.staging.transferz.com/transfercompanies/actions' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_STAGING_API_KEY' \
  --data '{
  "journeyId": 488213,
  "type": "TRAVELLER_NO_SHOW",
  "position": {
    "lat": 52.3094,
    "lng": 4.7622
  }
}'
```

```javascript title="JavaScript"
const response = await fetch("https://warpdrive.staging.transferz.com/transfercompanies/actions", {
  method: "POST",
  headers: {
    Accept: "application/json",
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_STAGING_API_KEY",
  },
  body: JSON.stringify({
    "journeyId": 488213,
    "type": "TRAVELLER_NO_SHOW",
    "position": {
      "lat": 52.3094,
      "lng": 4.7622
    }
  }),
});

const data = await response.json();
console.log(response.status, data);
```

```java title="Java"
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Example {
  public static void main(String[] args) throws Exception {
    String body = """
        {
          "journeyId": 488213,
          "type": "TRAVELLER_NO_SHOW",
          "position": {
            "lat": 52.3094,
            "lng": 4.7622
          }
        }
        """;

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://warpdrive.staging.transferz.com/transfercompanies/actions"))
        .header("Accept", "application/json")
        .header("Content-Type", "application/json")
        .header("X-API-Key", "YOUR_STAGING_API_KEY")
        .method("POST", HttpRequest.BodyPublishers.ofString(body))
        .build();

    HttpResponse<String> response = HttpClient.newHttpClient()
        .send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.statusCode());
    System.out.println(response.body());
  }
}
```

```csharp title="C#"
using System.Net.Http;
using System.Text;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://warpdrive.staging.transferz.com/transfercompanies/actions");
request.Headers.TryAddWithoutValidation("Accept", "application/json");
request.Headers.TryAddWithoutValidation("X-API-Key", "YOUR_STAGING_API_KEY");

var json = """
    {
      "journeyId": 488213,
      "type": "TRAVELLER_NO_SHOW",
      "position": {
        "lat": 52.3094,
        "lng": 4.7622
      }
    }
    """;
request.Content = new StringContent(json, Encoding.UTF8, "application/json");

using var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

```php title="PHP"
<?php

$body = <<<'JSON'
{
  "journeyId": 488213,
  "type": "TRAVELLER_NO_SHOW",
  "position": {
    "lat": 52.3094,
    "lng": 4.7622
  }
}
JSON;

$ch = curl_init('https://warpdrive.staging.transferz.com/transfercompanies/actions');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Content-Type: application/json',
        'X-API-Key: YOUR_STAGING_API_KEY',
    ],
    CURLOPT_POSTFIELDS => $body,
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

echo $status, PHP_EOL, $response, PHP_EOL;
```

**Response (200):**

```json
{
  "id": 140022,
  "journeyId": 488213,
  "created": "2026-12-01T15:32:10",
  "updated": "2026-12-01T15:32:10",
  "type": "TRAVELLER_NO_SHOW",
  "attachmentFileIds": []
}
```

Note that the position uses `lat` and `lng` here, not `latitude` and `longitude`. Keep the `id`: it
is the action id you attach evidence to.

## Step 3: Upload the evidence

Send the file as `multipart/form-data` in a part named `file`, one file per request. Accepted types
are JPEG, PNG, WebP, GIF and PDF; HEIC photos are refused, so convert them first. Set the part's
content type, such as `image/jpeg`.

**Request:** [`POST /actions/140022/photo`](https://developers.test.transferz.com/reference/transfer-companies/upload-action-attachment)

```bash title="cURL"
curl --request POST \
  --url 'https://warpdrive.staging.transferz.com/transfercompanies/actions/140022/photo' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: YOUR_STAGING_API_KEY'
```

```javascript title="JavaScript"
const response = await fetch("https://warpdrive.staging.transferz.com/transfercompanies/actions/140022/photo", {
  method: "POST",
  headers: {
    Accept: "application/json",
    "X-API-Key": "YOUR_STAGING_API_KEY",
  },
});

const data = await response.json();
console.log(response.status, data);
```

```java title="Java"
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Example {
  public static void main(String[] args) throws Exception {
    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://warpdrive.staging.transferz.com/transfercompanies/actions/140022/photo"))
        .header("Accept", "application/json")
        .header("X-API-Key", "YOUR_STAGING_API_KEY")
        .method("POST", HttpRequest.BodyPublishers.noBody())
        .build();

    HttpResponse<String> response = HttpClient.newHttpClient()
        .send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.statusCode());
    System.out.println(response.body());
  }
}
```

```csharp title="C#"
using System.Net.Http;
using System.Text;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://warpdrive.staging.transferz.com/transfercompanies/actions/140022/photo");
request.Headers.TryAddWithoutValidation("Accept", "application/json");
request.Headers.TryAddWithoutValidation("X-API-Key", "YOUR_STAGING_API_KEY");

using var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

```php title="PHP"
<?php

$ch = curl_init('https://warpdrive.staging.transferz.com/transfercompanies/actions/140022/photo');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'X-API-Key: YOUR_STAGING_API_KEY',
    ],
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

echo $status, PHP_EOL, $response, PHP_EOL;
```

**Response (200):**

```http
HTTP/1.1 200 OK
```

The generated samples above leave out the file. This is the full request:

```bash title="cURL"
curl --request POST \
  --url https://warpdrive.staging.transferz.com/transfercompanies/actions/140022/photo \
  --header 'X-API-Key: YOUR_STAGING_API_KEY' \
  --form 'file=@meeting-point.jpg;type=image/jpeg'
```

```javascript title="JavaScript"
import { readFile } from "node:fs/promises";

const form = new FormData();
const photo = await readFile("meeting-point.jpg");
form.append("file", new Blob([photo], { type: "image/jpeg" }), "meeting-point.jpg");

const response = await fetch(
  "https://warpdrive.staging.transferz.com/transfercompanies/actions/140022/photo",
  { method: "POST", headers: { "X-API-Key": "YOUR_STAGING_API_KEY" }, body: form },
);
if (!response.ok) throw new Error(`Upload failed: ${response.status}`);
```

To add more evidence, upload each file with its own request to the same action.

> **To be confirmed by Transferz:** The maximum file size is still to be confirmed by Transferz. The Transfer Companies API appears to
> accept files up to 1 MB, while the service behind it and the previous guide allow 25 MB. Keep files
> under 1 MB.

## Step 4: Check the action

List the actions of a journey to confirm the evidence arrived. `page` and `size` are required.

**Request:** [`GET /actions`](https://developers.test.transferz.com/reference/transfer-companies/search-actions)

```bash title="cURL"
curl --request GET \
  --url 'https://warpdrive.staging.transferz.com/transfercompanies/actions?journeyId=488213&page=0&size=10&sort=created;desc' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: YOUR_STAGING_API_KEY'
```

```javascript title="JavaScript"
const response = await fetch("https://warpdrive.staging.transferz.com/transfercompanies/actions?journeyId=488213&page=0&size=10&sort=created;desc", {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "YOUR_STAGING_API_KEY",
  },
});

const data = await response.json();
console.log(response.status, data);
```

```java title="Java"
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Example {
  public static void main(String[] args) throws Exception {
    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://warpdrive.staging.transferz.com/transfercompanies/actions?journeyId=488213&page=0&size=10&sort=created;desc"))
        .header("Accept", "application/json")
        .header("X-API-Key", "YOUR_STAGING_API_KEY")
        .method("GET", HttpRequest.BodyPublishers.noBody())
        .build();

    HttpResponse<String> response = HttpClient.newHttpClient()
        .send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.statusCode());
    System.out.println(response.body());
  }
}
```

```csharp title="C#"
using System.Net.Http;
using System.Text;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://warpdrive.staging.transferz.com/transfercompanies/actions?journeyId=488213&page=0&size=10&sort=created;desc");
request.Headers.TryAddWithoutValidation("Accept", "application/json");
request.Headers.TryAddWithoutValidation("X-API-Key", "YOUR_STAGING_API_KEY");

using var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

```php title="PHP"
<?php

$ch = curl_init('https://warpdrive.staging.transferz.com/transfercompanies/actions?journeyId=488213&page=0&size=10&sort=created;desc');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'X-API-Key: YOUR_STAGING_API_KEY',
    ],
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

echo $status, PHP_EOL, $response, PHP_EOL;
```

**Response (200):**

```json
{
  "pagination": { "currentPage": 0, "pageSize": 10, "totalPages": 1, "totalResults": 1 },
  "results": [
    {
      "id": 140022,
      "journeyId": 488213,
      "created": "2026-12-01T15:32:10",
      "updated": "2026-12-01T15:33:02",
      "type": "TRAVELLER_NO_SHOW",
      "attachmentFileIds": [99331]
    }
  ]
}
```

## Step 5: Complete the journey

Reporting a no-show through the API does not change the journey's status. Complete the journey as
usual; see [Complete a journey](https://developers.test.transferz.com/guides/transfer-companies/complete-a-journey).

## Errors

| Status | Code                                                                                                        | Cause                                                                   | What to do                                                                                     |
| ------ | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `400`  | `INVALID_REQUEST`                                                                                           | `journeyId` or `type` is missing.                                       | Send both.                                                                                     |
| `500`  | `UNKNOWN`                                                                                                   | A type other than `TRAVELLER_NO_SHOW` or `DRIVER_LEFT_PICKUP` was sent. | Use one of the two accepted types. Do not retry unchanged.                                     |
| `400`  | [UNSUPPORTED_CONTENT_TYPE](https://developers.test.transferz.com/reference/errors/unsupported-content-type) | The file is not a JPEG, PNG, WebP, GIF or PDF.                          | Convert the file and send its content type with the part.                                      |
| `400`  | —                                                                                                           | The part has no content type.                                           | Set the part's content type, such as `image/jpeg`.                                             |
| `4xx`  | —                                                                                                           | The upload has no part named `file`, or the file is empty or too large. | Send one non-empty file of at most 1 MB in a part named `file`.                                |
| `403`  | `INSUFFICIENT_PERMISSIONS`                                                                                  | The journey is not assigned to your company, or the id does not exist.  | Check the journey id and the action id.                                                        |
| `401`  | —                                                                                                           | The API key is missing, wrong or expired.                               | See [Authentication](https://developers.test.transferz.com/guides/get-started/authentication). |

The error format is described in [Errors](https://developers.test.transferz.com/guides/essentials/errors).

## Related

### Endpoints

- [POST Create action](https://developers.test.transferz.com/reference/transfer-companies/create-action) (`POST /actions`)
- [POST Upload attachment](https://developers.test.transferz.com/reference/transfer-companies/upload-action-attachment) (`POST /actions/{actionId}/photo`)
- [GET Search actions](https://developers.test.transferz.com/reference/transfer-companies/search-actions) (`GET /actions`)
