Carsan for AI agents

Carsan rents cars in Los Angeles and Miami. An agent can search cars, check dates, and get prices without an account.

With an API key that the customer creates, the agent works on that customer's account. Payment, card addition, extension, and identity verification always stay with the customer.

What an agent can do

Without a key

Search cars by city (la, miami) and dates.
Read car details.
Get a price quote for dates and options.

With the customer's API key

Read the profile, verification status, trips, trip costs, invoices, and the saved card's brand and last four digits.
Get customer links for payment, card addition, and extension.
Create and cancel reservations under the normal rules (booking_write keys only).

Customer only

Sign up, start and complete identity verification (KYC).
Pay, add a card, and confirm an extension in the Carsan app.
Create and revoke API keys.

Search and price without an account

Send no credentials on these calls. Dates are car-local YYYY-MM-DDTHH:MM: Los Angeles uses America/Los_Angeles, Miami uses America/New_York. Amounts are integer USD cents.

Search (sample data)

curl "https://api.carsan.com/v1/cars?city=la&date_from=2026-11-10T10:00&date_to=2026-11-13T10:00&limit=20"

Result

{
  "data": {
    "cars": [
      {
        "car_id": 101,
        "car_alias": "Los_Angeles_Toyota_Camry_2023_SAMPLE",
        "name": "Toyota Camry 2023",
        "city": "la",
        "is_available": true,
        "trip_days": 3,
        "rent_trip_total_cents": 17100,
        "rent_trip_savings_cents": 900,
        "display_trip_total_cents": 21600
      }
    ],
    "total": 1,
    "has_more": false
  }
}

Quote the dates and options

curl -X POST "https://api.carsan.com/v1/reservation/quote" \
  -H "Content-Type: application/json" \
  -d '{ "car_alias": "Los_Angeles_Toyota_Camry_2023_SAMPLE", "date_checkin": "2026-11-10T10:00", "date_checkout": "2026-11-13T10:00", "options": { "protection_plan": "minimum", "mileage_type": "limited", "delivery_type": "pickup" }, "extras": [] }'

Result

{
  "data": {
    "rent_subtotal": 18000,
    "rent_discount_amount": 900,
    "protection_total": 4500,
    "trip_fee_total": 4500,
    "final_total": 26100,
    "display_total": 26100,
    "display_mode": "trip_total",
    "display_trip_total": 26100,
    "blended_day_rate": 7500,
    "discounted_day_rate": 7200,
    "deposit_cents": 30000
  }
}

final_total excludes the refundable deposit; deposit_cents is separate. A quote does not hold the car or guarantee a later price.

Continue with the customer's account

The customer signs up at app.carsan.com.
The customer opens Settings → API Keys and creates a key. read_only reads the account; booking_write also creates and cancels reservations.
The customer gives the key to the agent. It is shown once.
The agent sends it as Authorization: Bearer carsan_YOUR_API_KEY or X-API-Key: carsan_YOUR_API_KEY.

An API key is not driver approval. The customer starts and completes verification personally.

Customer actions

For payment, card addition, or extension the API returns a Carsan link. The link executes nothing and carries no key.

Payment link response (sample)

{
  "data": {
    "action": "pay_reservation",
    "status": "requires_user_action",
    "url": "https://app.carsan.com/trips/00000000-0000-4000-8000-000000000001?intent=pay&payment_type=reservation"
  }
}

Give the url to the customer.
The customer opens it, logs in if needed, reviews current details, and confirms.
Read GET /my/reservation/00000000-0000-4000-8000-000000000001 again to report the actual result. A generated or visited link is not completion.

Carsan for AI agents

What an agent can do

Search and price without an account

Continue with the customer's account

Customer actions

More