Get all Organizations

Documentation Index

Fetch the complete documentation index at: https://docs.unpod.dev/llms.txt

Use this file to discover all available pages before exploring further.

{
  "count": 3,
  "status_code": 200,
  "message": "Organizations fetched successfully",
  "data": [
    {
      "id": 1,
      "name": "Unpod TV",
      "domain_handle": "unpod.tv",
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": 2,
      "name": "Recalll",
      "domain_handle": "recalll.co",
      "created_at": "2024-03-20T08:00:00Z"
    }
  ]
}

​

Organizations API

​

Response Fields

​

Organization Object Fields

​

Common Error Codes

​

Code Examples

const axios = require('axios');

const headers = {
  'Authorization': 'Token your-api-token',
  'Org-Handle': 'your-org-handle'
};

// Get all organizations
const getOrganizations = async () => {
  const response = await axios.get(
    'https://unpod.ai/api/v2/platform/organizations/',
    { headers }
  );
  console.log(`Total organizations: ${response.data.count}`);
  response.data.data.forEach(org => {
    console.log(`${org.name} - Handle: ${org.domain_handle}`);
  });
  return response.data.data;
};

// Example usage
getOrganizations();

​

Best Practices

1. Org-Handle: Use the domain_handle from the response as the Org-Handle header in all subsequent requests
2. Caching: Cache organization data locally to reduce API calls since organizations change infrequently
3. Error Handling: Always handle potential errors and edge cases
4. Security: Keep API tokens secure and rotate them regularly
5. Multiple Orgs: If you have access to multiple organizations, store all handles and switch between them as needed