Organization

The organization endpoints let you retrieve info about the organization associated with your API key.

Get organization

GET /api/v1/org

Returns the organization details and resource counts for the authenticated API key’s organization.

Required scope: org.read

curl -X GET https://app.insigner.co/api/v1/org \
  -H "Authorization: Bearer isk_YOUR_API_KEY"

const res = await fetch('https://app.insigner.co/api/v1/org', {
  headers: { 'Authorization': 'Bearer isk_YOUR_API_KEY' }
});
const { data } = await res.json();

res = requests.get(
    "https://app.insigner.co/api/v1/org",
    headers={"Authorization": "Bearer isk_YOUR_API_KEY"}
)

Response

{
  "data": {
    "id": "org_abc123",
    "name": "Acme Corporation",
    "slug": "acme-corporation",
    "type": "business",
    "image": "https://storage.example.com/logos/acme.png",
    "signatureLevel": "advanced",
    "timestampProvider": "default",
    "defaultOtpMethod": "email",
    "createdAt": "2025-01-15T10:00:00.000Z",
    "updatedAt": "2026-05-28T14:00:00.000Z",
    "_count": {
      "members": 12,
      "documents": 1847,
      "templates": 23,
      "campaigns": 5,
      "apiKeys": 3
    }
  }
}

List members

GET /api/v1/org/members

Returns all members of the organization with their roles.

Required scope: org.read

curl -X GET https://app.insigner.co/api/v1/org/members \
  -H "Authorization: Bearer isk_YOUR_API_KEY"

const res = await fetch('https://app.insigner.co/api/v1/org/members', {
  headers: { 'Authorization': 'Bearer isk_YOUR_API_KEY' }
});
const { data } = await res.json();

res = requests.get(
    "https://app.insigner.co/api/v1/org/members",
    headers={"Authorization": "Bearer isk_YOUR_API_KEY"}
)

Response

{
  "data": [
    {
      "id": "usr_abc123",
      "name": "María García",
      "email": "[email protected]",
      "image": "https://storage.example.com/avatars/maria.jpg",
      "role": "owner",
      "joinedAt": "2025-01-15T10:00:00.000Z"
    },
    {
      "id": "usr_def456",
      "name": "Carlos López",
      "email": "[email protected]",
      "image": null,
      "role": "admin",
      "joinedAt": "2025-02-01T08:00:00.000Z"
    },
    {
      "id": "usr_ghi789",
      "name": "Ana Martínez",
      "email": "[email protected]",
      "image": null,
      "role": "member",
      "joinedAt": "2025-03-10T14:00:00.000Z"
    }
  ]
}