Authentication

Searching and listing slots need no key. Quoting and booking need your app's key. The manage calls take the booking's manage token instead.

Keys

  • App keyAuthorization: Bearer vmk_...

    Your app's API key (vmk_live_... or vmk_test_...). Optional for reading: without one you can search and list slots but not quote or book.

  • Operator keyAuthorization: Bearer vmo_...

    A business operator key (vmo_...). Required.

Manage token

  • x-manage-tokenstringRequired

    The manageToken returned by create_booking. Proves the caller is the customer. Never show it to anyone else.

Headers on every call

  • x-vamos-end-userstring

    Your own opaque id for the person this request is for (letters, digits and . _ : @ ~ -, up to 128 characters). Holds and rate limits are then counted per person, so one user's browsing cannot use up the whole app's budget. Optional.

  • cursorstring (up to 512 characters)

    Opaque pagination cursor: pass back the nextCursor you were given, unchanged.

Getting a key

To ask for a key, write to hello@yovamos.com.