# Getting started as a partner

> Make your first call to the Transferz staging API from your own system. You need the onboarding email from Transferz. About 10 minutes.

Section: Partners · Last updated: 2026-11-18

## Sign in with your integration account

Transferz set up two staging accounts for you and emailed the details. Your **person account** is for
you. Your **integration account** (`…@integrations.staging.transferz.com`) is the one your system
uses. API keys and request recording belong to the account that creates them, so do every step on
this page signed in with the integration account.

The first time you sign in, Transferz asks you to choose a new password. Nobody can receive email at
the integration address, so "Forgot password" doesn't work for it. If you lose the password,
[ask Transferz in a support ticket](https://developers.staging.transferz.com/support/new).

Sign in at <https://developers.staging.transferz.com/sign-in> with your integration account.

## Create an API key

Your system sends an API key in the `X-API-Key` header of every call. The key belongs to the account
that creates it: here, your integration account. Store it in your secret store, never in source code
or browser code. A key expires three months after it was last used.

Create a key in Workspace › API keys (<https://developers.staging.transferz.com/workspace/staging/api-keys>).

## Make your first call

Search for KLM flights from London Heathrow to Amsterdam Schiphol, a week from today. Send the
request from your terminal or your own code, not from this portal: the point is to prove that your
system can reach Transferz staging with your key.

**Request:** [`GET /flights/search`](https://developers.staging.transferz.com/reference/partners/search-flights)

```bash title="cURL"
curl --request GET \
  --url 'https://warpdrive.staging.transferz.com/partners/flights/search?airlineIataCode=KL&departureAirportIataCode=LHR&arrivalAirportIataCode=AMS&arrivalDate=2026-11-28' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: YOUR_STAGING_API_KEY'
```

```javascript title="JavaScript"
const response = await fetch("https://warpdrive.staging.transferz.com/partners/flights/search?airlineIataCode=KL&departureAirportIataCode=LHR&arrivalAirportIataCode=AMS&arrivalDate=2026-11-28", {
  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/partners/flights/search?airlineIataCode=KL&departureAirportIataCode=LHR&arrivalAirportIataCode=AMS&arrivalDate=2026-11-28"))
        .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/partners/flights/search?airlineIataCode=KL&departureAirportIataCode=LHR&arrivalAirportIataCode=AMS&arrivalDate=2026-11-28");
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/partners/flights/search?airlineIataCode=KL&departureAirportIataCode=LHR&arrivalAirportIataCode=AMS&arrivalDate=2026-11-28');
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
[
  {
    "flightDesignators": [
      { "airlineCode": "KL", "flightNumber": "1234", "primary": true, "airlineName": "KLM" }
    ],
    "scheduledDepartureTimeLocal": "2026-11-28T11:15:00",
    "departureAirportIataCode": "LHR",
    "scheduledArrivalTimeLocal": "2026-11-28T13:40:00",
    "arrivalAirportIataCode": "AMS",
    "departureAirportCountryCode": "GB",
    "arrivalAirportCountryCode": "NL"
  }
]
```

A `200` response with a list of KL flights from LHR to AMS on that date. Each flight has its flight
number (`flightDesignators`), scheduled times and airports. An empty list is also a successful call:
it means no flights were found on that date.

This page sees your call in your request log: calls made with this account's staging API keys
appear in [Workspace › Request log](https://developers.staging.transferz.com/workspace/staging/requests), with method, path, status, duration,
and the request and response bodies, failed calls included. Requests are kept for 48 hours. You'll
use it to debug while you build.

Send the request above from your terminal or your own code, then open the request log (<https://developers.staging.transferz.com/workspace/staging/requests>) to see it arrive.

## Stuck?

- Ask AI answers from these docs. Open it with ⌘I or the Ask AI button in the header.
- For anything about your accounts or staging, [ask Transferz in a support ticket](https://developers.staging.transferz.com/support/new).

## Related

### Endpoints

- [GET Search flights](https://developers.staging.transferz.com/reference/partners/search-flights) (`GET /flights/search`)

Next: [How a booking works](https://developers.staging.transferz.com/guides/partners/how-a-booking-works)
