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.
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
datefield usesYYYY-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 thejumpNumberfilter on the list endpoint. - Errors use a consistent envelope, sometimes with an extra
detailsarray for validation failures:
{ "error": { "code": "not_found", "message": "Human-readable message" } }
Status codes:
400— invalid request body or query parameters401— missing or invalid credentials403— authenticated, but not allowed to modify this entry404— entry does not exist, or is not visible to you409— jump number already in use422— 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 | experimentalweatherCondition:SUNNY | BROKEN | CLOUDY | RAINY | THUNDER | SNOWY | HAIL | MISTYwindDirection:HEADWIND | TAILWIND | CROSSWINDgear.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'spagination.nextCursor.jumpNumber— exact match; returns the single matching entry indata.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 }