GET
/
v1
/
vault
/
connections
curl --location --request GET 'https://api.picaos.com/v1/vault/connections' \
--header 'x-pica-secret: YOUR_API_KEY'
{
  "type": "Vault Connections",
  "rows": [
    {
      "id": "673f79c6-0110-408b-bcbe-f4da000e66c7",
      "platformVersion": "1.0.0",
      "name": null,
      "type": "api",
      "key": "test::resend::default::46f75762f34e4962bf5684760f0f9f0e",
      "environment": "test",
      "platform": "resend",
      "identity": "46f75762f34e4962bf5684760f0f9f0e",
      "identityType": "user",
      "description": "Email API for developers",
      "tags": [],
      "version": "1.0.0",
      "active": true,
      "createdAt": "2025-07-19T16:19:29.702632Z"
    },
    ...
  ],
  "total": 20,
  "pages": 2,
  "page": 1
}

Query Parameters

key
string
A comma separated list of connection keys
platformVersion
string
The platform version
name
string
The connection name
identityType
"user" | "team" | "organization" | "project"
The identity type
identity
string
The connection identifier
platform
string
The connector platform (e.g. stripe, exa)
tags
string
A comma separated list of tags
active
boolean
default:"true"
Filter connections by active status
limit
number
default:"20"
The number of connections to return
skip
number
default:"0"
The number of connections to skip

Response

connections
Connection[]
Array of Connection objects
curl --location --request GET 'https://api.picaos.com/v1/vault/connections' \
--header 'x-pica-secret: YOUR_API_KEY'
{
  "type": "Vault Connections",
  "rows": [
    {
      "id": "673f79c6-0110-408b-bcbe-f4da000e66c7",
      "platformVersion": "1.0.0",
      "name": null,
      "type": "api",
      "key": "test::resend::default::46f75762f34e4962bf5684760f0f9f0e",
      "environment": "test",
      "platform": "resend",
      "identity": "46f75762f34e4962bf5684760f0f9f0e",
      "identityType": "user",
      "description": "Email API for developers",
      "tags": [],
      "version": "1.0.0",
      "active": true,
      "createdAt": "2025-07-19T16:19:29.702632Z"
    },
    ...
  ],
  "total": 20,
  "pages": 2,
  "page": 1
}