navan-hello-world

# Navan Hello World ## Overview Execute a first API call against the Navan REST API to retrieve trip data. All examples use raw REST calls — Navan has **no public SDK**. **Purpose:** Confirm end-to-end integration by retrieving real trip data and parsing `uuid` primary keys. ## Prerequisites - Completed `navan-install-auth` with working OAuth 2.0 credentials - `.env` file with `NAVAN_CLIENT_ID`, `NAVAN_CLIENT_SECRET`, and `NAVAN_BASE_URL` - Node.js 18+ (for TypeScript) or Python 3.8+ (for Python) - At least one trip or user in your Navan organization ## Instructions ### Step 1: Acquire a Bearer Token Reuse the token exchange from `navan-install-auth`: ```typescript import 'dotenv/config'; async function getNavanToken(): Promise<string> { const response = await fetch(`${process.env.NAVAN_BASE_URL}/ta-auth/oauth/token`, { method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, body: new URLSearchParams({ grant_type: 'client_credentials', client_id: process.env.NAVAN_CLIENT_ID!, client_secret: process.env.NAVAN_CLIENT_SECRET!, }), }); if (!response.ok) throw new Error(`Auth failed: ${response.status}`); const data = await response.json(); return data.access_token; } ``` ### Step 2: Retrieve Bookings (TypeScript) Call `GET /v1/bookings` to fetch booking records (paginated with `page` + `size`): ```typescript interface NavanBooking { uuid: string; // Primary key for all booking records ...