Skip to main content
Previous API version. Use GET /workspaces for new integrations. This route still works but is deprecated.
Retrieve all companies (now called workspaces) that the authenticated user has authorized your application to access. 
GET https://connect.penbox.io/v1/companies

​
Response

Unlike the current GET /workspaces endpoint, this route returns a bare JSON array with no pagination meta envelope.
[
  {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "created_at": "2024-01-15T10:30:00Z",
    "slug": "acme-corp",
    "name": "Acme Corp"
  }
]
The slug is a URL-safe, unique identifier used in API calls to specify which workspace you want to interact with.

​
Example

cURL
curl 'https://connect.penbox.io/v1/companies' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

​
Response Codes

CodeDescription
200Success — returns array of companies
401Unauthorized
403Forbidden
429Too Many Requests
500Server Error