Skip to content
GateVia Docs

Quickstart

The GateVia public API lives at https://api.gatevia.app/api/v1. Every request is authenticated with a per-Space API key. A key belongs to exactly one Space and can only touch that Space.

1. Create an API key

  1. Sign in at app.gatevia.app as an admin of your Space.
  2. Go to Settings → API keys → Create key.
  3. Give it a name (e.g. PMS integration) and pick its permissions.
  4. Copy the secret (gv_live_…) — it is shown exactly once. If you lose it, revoke the key and create a new one.

API access requires the Pro plan or higher (a trial also works).

2. Make your first call

List the gates in your Space:

Terminal window
curl https://api.gatevia.app/api/v1/gates \
  -H "Authorization: Bearer gv_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
{
  "gates": [
    {
      "id": "665f1c2ab9d1a2c3d4e5f601",
      "name": "Main entrance",
      "phoneNumber": "+40712345678",
      "location": "12 Florilor Street",
      "isActive": true,
      "openCount": 42,
      "lastOpenedAt": "2026-07-10T18:03:12.000Z",
      "createdAt": "2026-06-01T09:00:00.000Z"
    }
  ]
}

3. Invite a member with gate access

Create a member, grant them a gate on a weekday schedule, and GateVia emails them their magic link automatically:

Terminal window
curl -X POST https://api.gatevia.app/api/v1/members \
  -H "Authorization: Bearer gv_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ana Popescu",
    "email": "[email protected]",
    "accesses": [
      {
        "gateId": "665f1c2ab9d1a2c3d4e5f601",
        "schedules": [
          { "type": "weekdays", "timeWindows": [{ "from": "09:00", "to": "18:00" }] }
        ]
      }
    ]
  }'

The response includes the member, their access and the accessUrl magic link. One link opens every gate the member has been granted.

Next steps