API reference
Passwords
Zero-knowledge vault access. Items are encrypted on the person's devices.
Base URL https://api.pinal.tech/v1
API reference
Zero-knowledge vault access. Items are encrypted on the person's devices.
Base URL https://api.pinal.tech/v1
/passwords/autofillAsks the person's device to fill a login for origin. They approve it there; you get back an encrypted item only your app's session key can open.
origin string required public_key string required Your ephemeral X25519 public key (base64url).
curl -X POST "https://api.pinal.tech/v1/passwords/autofill" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"origin": "https://example.com",
"public_key": "string"
}'{
"request_id": "string",
"expires_at": "2026-11-19T15:20:04Z"
}/passwords/itemsEncrypted items. Decrypting needs the person's vault key, which never leaves their devices.
limit integer Items per page, 1–100.
cursor string Opaque cursor from a previous page's next_cursor.
curl "https://api.pinal.tech/v1/passwords/items" \
-H "Authorization: Bearer $ACCESS_TOKEN"{
"items": [
{
"id": "string",
"kind": "login",
"origins": [
"string"
],
"ciphertext": "string",
"updated_at": "2026-11-19T15:20:04Z"
}
],
"next_cursor": "string"
}/passwords/itemsStores an item you encrypted client-side with the person's vault key.
id string read-onlykind string One of login card note identity
origins array of string ciphertext string XChaCha20-Poly1305, base64url. Pinal can't read it.
updated_at string (date-time) read-onlycurl -X POST "https://api.pinal.tech/v1/passwords/items" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"id": "string",
"kind": "login",
"origins": [
"string"
],
"ciphertext": "string",
"updated_at": "2026-11-19T15:20:04Z"
}'{
"id": "string",
"kind": "login",
"origins": [
"string"
],
"ciphertext": "string",
"updated_at": "2026-11-19T15:20:04Z"
}