# Meet and greet

> Report that the host met the traveller for journeys with meet and greet.

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

You will record the moment your host or driver met the traveller, for example at the name sign in
the arrivals hall. You need an API key and a journey assigned to your company.

A journey has meet and greet when its `addonsPerQuantity` contains `MEET_GREET`. The host waits with a
sign showing `travellerInfo.meetAndGreetSignText` at the journey's `meetingPoint`. Recording the
meeting tells Transferz when and where the traveller was met.

## Step 1: Record the meeting

Send the position where the host met the traveller and the moment it happened:

**Request:** [`PUT /journeys/488213/host-traveller-met`](https://developers.test.transferz.com/reference/transfer-companies/mark-host-met-traveller)

```bash title="cURL"
curl --request PUT \
  --url 'https://warpdrive.staging.transferz.com/transfercompanies/journeys/488213/host-traveller-met' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_STAGING_API_KEY' \
  --data '{
  "latitude": 52.3094,
  "longitude": 4.7622,
  "recordedAt": "2026-12-01T13:48:00"
}'
```

```javascript title="JavaScript"
const response = await fetch("https://warpdrive.staging.transferz.com/transfercompanies/journeys/488213/host-traveller-met", {
  method: "PUT",
  headers: {
    Accept: "application/json",
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_STAGING_API_KEY",
  },
  body: JSON.stringify({
    "latitude": 52.3094,
    "longitude": 4.7622,
    "recordedAt": "2026-12-01T13:48:00"
  }),
});

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 = """
        {
          "latitude": 52.3094,
          "longitude": 4.7622,
          "recordedAt": "2026-12-01T13:48:00"
        }
        """;

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://warpdrive.staging.transferz.com/transfercompanies/journeys/488213/host-traveller-met"))
        .header("Accept", "application/json")
        .header("Content-Type", "application/json")
        .header("X-API-Key", "YOUR_STAGING_API_KEY")
        .method("PUT", 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.Put, "https://warpdrive.staging.transferz.com/transfercompanies/journeys/488213/host-traveller-met");
request.Headers.TryAddWithoutValidation("Accept", "application/json");
request.Headers.TryAddWithoutValidation("X-API-Key", "YOUR_STAGING_API_KEY");

var json = """
    {
      "latitude": 52.3094,
      "longitude": 4.7622,
      "recordedAt": "2026-12-01T13:48:00"
    }
    """;
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'
{
  "latitude": 52.3094,
  "longitude": 4.7622,
  "recordedAt": "2026-12-01T13:48:00"
}
JSON;

$ch = curl_init('https://warpdrive.staging.transferz.com/transfercompanies/journeys/488213/host-traveller-met');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PUT',
    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 (204):**

```http
HTTP/1.1 204 No Content
```

All fields are optional. `recordedAt` is in UTC and defaults to the time of the request; a time in
the past is kept, so you can send the meeting after it happened. Send both coordinates or neither.

## Step 2: Check the journey

[Get a journey](https://developers.test.transferz.com/reference/transfer-companies/get-journey) now returns the meeting:

```json
{
  "hostTravellerMetTime": "2026-12-01T13:48:00",
  "hostTravellerMetPosition": { "latitude": 52.3094, "longitude": 4.7622 }
}
```

## Rules worth knowing

- **Before the ride starts.** The meeting can be recorded while the journey is `CONFIRMED`, `PLANNED`,
  `DRIVER_UNDERWAY` or `DRIVER_ARRIVED`; not once it is `JOURNEY_IN_PROGRESS`, completed or cancelled.
  Record it before you send [in progress](https://developers.test.transferz.com/reference/transfer-companies/set-journey-in-progress).
- **Once only.** The first record stands; a second call is refused.
- **No status change and no event.** The journey keeps its status, and no webhook event is sent to you
  or the partner. Report the stages separately; see
  [Report journey progress](https://developers.test.transferz.com/guides/transfer-companies/report-journey-progress).

## Errors

| Status | Code                                                                                                                                          | Cause                                                                  | What to do                                                                                     |
| ------ | --------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `400`  | [HOST_TRAVELLER_MET_NOT_ALLOWED_FOR_STATUS](https://developers.test.transferz.com/reference/errors/host-traveller-met-not-allowed-for-status) | The journey is in progress, completed or cancelled.                    | Record the meeting before the traveller boards.                                                |
| `400`  | [HOST_TRAVELLER_MET_ALREADY_RECORDED](https://developers.test.transferz.com/reference/errors/host-traveller-met-already-recorded)             | The meeting was already recorded.                                      | Nothing to do; the first record stands. Treat it as success when retrying.                     |
| `400`  | [HOST_TRAVELLER_MET_TIME_IN_FUTURE](https://developers.test.transferz.com/reference/errors/host-traveller-met-time-in-future)                 | `recordedAt` is later than now.                                        | Send the time in UTC, or leave `recordedAt` out.                                               |
| `403`  | `INSUFFICIENT_PERMISSIONS`                                                                                                                    | The journey is not assigned to your company, or the id does not exist. | Check the 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

- [PUT Mark that the host met the traveller](https://developers.test.transferz.com/reference/transfer-companies/mark-host-met-traveller) (`PUT /journeys/{id}/host-traveller-met`)
- [GET Get journey](https://developers.test.transferz.com/reference/transfer-companies/get-journey) (`GET /journeys/{id}`)
