Vector API reference
This read-only partner API lists flights in the organization of the user who issued the key. Account access is currently limited.
GET /api/v1/flights
Send an existing Vector API key using Authorization: Bearer <VECTOR_API_KEY> or the X-API-Key header. The key must have the vector:flights:read scope.
Optional query parameter: baseId, 1–128 letters, digits, underscores or hyphens. The base must belong to the key owner’s organization. Omit it to read all flights in that organization.
Success response
200 application/json returns { flights: Flight[] }. No matching flights returns { "flights": [] }.
Each flight includes string fields id, userId, origin, destination, status; nullable strings orgId, aircraftId, flightNumber, pilotName, notes; nullable integer passengerCount; nullable ISO-8601 timestamps departureTime, arrivalTime; and ISO-8601 timestamps createdAt, updatedAt.
Error responses
Errors use application/problem+json with type, title, status, detail, instance, code. The instance identifies the request.
- 400
- Invalid, unknown or cross-organization baseId.
- 401
- Missing, unknown or revoked API key.
- 403
- The key lacks vector:flights:read.
- 429
- Rate limit reached. Wait for the Retry-After interval before retrying.
- 500
- The flight read failed.