Skip to content
Return home

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.
Contact us about limited account access