Skip to main content

REST API

The Paraportal REST API lets external integrators manage a user's skydiving logbook entries and read the reference data those entries depend on — dropzones, aircraft, and gear. It is authenticated with a per-user API key over HTTP Basic auth.

note

This is v1, which currently supports skydive logbook entries only.

Base URL​

https://api-prod.paraportalapp.com/api/v1

All request and response bodies are JSON (Content-Type: application/json).

Authentication​

The API uses HTTP Basic auth:

  • Username — your Paraportal user ID (a UUID)
  • Password — your API key
Authorization: Basic base64("<userId>:<apiKey>")

For example, with curl:

curl -u "<userId>:<apiKey>" https://api-prod.paraportalapp.com/api/v1/logbook/entries

Missing or invalid credentials return 401 with a WWW-Authenticate: Basic challenge.

API keys​

Generate and manage your key on API key management page.

Each user has a single API key. Generating a new key invalidates the previous one.

Conventions​

  • References to a dropzone, aircraft, or gear item are UUID strings in both requests and responses. Resolve their display data through the reference data endpoints.
  • The date field uses YYYY-MM-DD. Timestamps (createdAt, updatedAt) are ISO-8601 in UTC.
  • The canonical identifier for an entry is its immutable id (UUID). To look one up by jump number, use the jumpNumber filter on the list endpoint.
  • Errors use a consistent envelope, sometimes with an extra details array for validation failures:
{ "error": { "code": "not_found", "message": "Human-readable message" } }

Status codes:

  • 400 — invalid request body or query parameters
  • 401 — missing or invalid credentials
  • 403 — authenticated, but not allowed to modify this entry
  • 404 — entry does not exist, or is not visible to you
  • 409 — jump number already in use
  • 422 — a referenced dropzone, aircraft, or gear item does not exist (or the aircraft fields are inconsistent)
  • 500 — unexpected server error

Enums​

  • aircraftType: airplane | helicopter | balloon | experimental
  • weatherCondition: SUNNY | BROKEN | CLOUDY | RAINY | THUNDER | SNOWY | HAIL | MISTY
  • windDirection: HEADWIND | TAILWIND | CROSSWIND
  • gear.type: canopy | container | wingsuit | altimeter | suit | helmet | aad | audible | tracksuit | other

Logbook entries​

Skydive entry​

{
"id": "uuid",
"sport": "skydive",
"date": "2026-06-01",
"jumpNumber": 1234,
"dropzoneId": "uuid",
"aircraftId": "uuid|null",
"aircraftModelId": "uuid|null",
"aircraftType": "airplane",
"exitAltitudeFt": 13000,
"openingAltitudeFt": 3000,
"freefallTimeSeconds": 55,
"isSelfDeployed": true,
"isReserveUsed": false,
"gearIds": ["uuid"],
"weatherCondition": "SUNNY",
"temperatureC": 18,
"windDirection": "HEADWIND",
"windSpeedMs": 4,
"distanceFromTargetFt": 10,
"emojis": [],
"personalNote": "string|null",
"createdAt": "2026-06-01T10:00:00Z",
"updatedAt": "2026-06-01T10:00:00Z"
}

GET /logbook/entries​

List your skydive entries, newest first.

Query parameters:

  • beforeEntryId — pagination cursor; pass the previous page's pagination.nextCursor.
  • jumpNumber — exact match; returns the single matching entry in data.
  • years, dropzoneIds, aircraftIds, aircraftModelIds, aircraftTypes — comma-separated filters.
{
"data": [ /* skydive entries */ ],
"pagination": { "hasMore": true, "nextCursor": "uuid|null" }
}

Paginate by passing nextCursor as beforeEntryId until hasMore is false.

POST /logbook/entries​

Create a skydive entry. Returns 201 with the created entry.

  • Required: jumpNumber, dropzoneId, date, exitAltitudeFt, freefallTimeSeconds, isReserveUsed.
  • Optional, with defaults: aircraftType (airplane), isSelfDeployed (true), gearIds ([]), emojis ([]).
  • Optional, nullable: aircraftId, aircraftModelId, openingAltitudeFt, weatherCondition, temperatureC, windDirection, windSpeedMs, distanceFromTargetFt, personalNote.
  • Write-only: taggedUserIds — an array of Paraportal user UUIDs to tag as having jumped with you. Accepted on create and update, but not returned on the entry.

Returns 409 if the jump number is already used.

GET /logbook/entries/:id​

Fetch a single entry by its UUID. Returns 404 if it is not yours.

PUT /logbook/entries/:id​

Replace an entry. Accepts the same body as create and overwrites every mutable field. Returns 403 if you are not the owner (or an instructor of the owner), and 404 if the entry does not exist.

DELETE /logbook/entries/:id​

Delete an entry. Returns 204 with no body.

Reference data​

These endpoints resolve the UUIDs referenced by logbook entries. Each returns { "data": [ ... ] }.

GET /dropzones?search=​

Search dropzones by name, alternative name, city, or ICAO code (case-insensitive). Returns up to 20 results; omit search to list dropzones alphabetically.

{ "id": "uuid", "name": "...", "altName": "string|null", "country": "FI", "city": "string|null", "icao": "string|null", "latitude": 0, "longitude": 0 }

GET /aircraft?search=​

Search aircraft by tail number or nickname (case-insensitive). Returns up to 100 results; omit search to list all.

{ "id": "uuid", "tailNumber": "...", "model": { "id": "uuid", "name": "...", "type": "airplane" }, "maxAltitudeM": null, "minJumpers": null, "maxJumpers": null, "nicknames": [] }

GET /gear​

List your own gear.

{ "id": "uuid", "type": "canopy", "name": "...", "remarks": "string|null", "isRetired": false }