Basic request:

curl 'https://your-domain.pamdas.org/api/v1.0/activity/events/' \
  -H 'Authorization: Bearer YOUR_TOKEN_HERE' \
  -H 'Accept: application/json'

With filters and pagination:

curl 'https://your-domain.pamdas.org/api/v1.0/activity/events/?state=new&state=active&page_size=50&sort_by=-updated_at' \
  -H 'Authorization: Bearer YOUR_TOKEN_HERE' \
  -H 'Accept: application/json'

With date range and bounding box:

curl 'https://your-domain.pamdas.org/api/v1.0/activity/events/?bbox=34.5,-2.5,34.6,-2.3&since=2024-10-01T00:00:00Z&until=2024-10-19T23:59:59Z' \
  -H 'Authorization: Bearer YOUR_TOKEN_HERE' \
  -H 'Accept: application/json'

With advanced filter (text search):

# URL-encoded filter: {"text":"elephant"}
curl 'https://your-domain.pamdas.org/api/v1.0/activity/events/?filter=%7B%22text%22%3A%22elephant%22%7D' \
  -H 'Authorization: Bearer YOUR_TOKEN_HERE' \
  -H 'Accept: application/json'

Using the official EarthRanger Python client (er-client):

Install with: pip install earthranger-client

from erclient.client import ERClient

# Initialize client
client = ERClient(
    service_root='https://your-domain.pamdas.org/api/v1.0',
    token='YOUR_TOKEN_HERE'
)

# Basic request - auto-paginates through all results
for event in client.get_events():
    print(f"{event['serial_number']}: {event.get('title', 'No title')}")
    print(f"  Type: {event['event_type']}")
    print(f"  Location: {event.get('location')}")
    print(f"  Time: {event['time']}")

# With filters and limits
events_list = []
for event in client.get_events(
    state='active',
    page_size=50,
    include_notes=True,
    include_files=True,
    max_results=100  # Limit total results
):
    events_list.append(event)

print(f"Found {len(events_list)} active events")

# Filter by date range
from datetime import datetime, timedelta
since = datetime.now() - timedelta(days=7)
for event in client.get_events(
    state='active',
    since=since.isoformat(),
    max_results=50
):
    print(f"Recent event: {event['title']}")

Using requests library directly:

import requests

API_URL = 'https://your-domain.pamdas.org/api/v1.0'
TOKEN = 'YOUR_TOKEN_HERE'

headers = {
    'Authorization': f'Bearer {TOKEN}',
    'Accept': 'application/json'
}

# Request with multiple filters
params = {
    'state': ['active', 'new'],  # Multiple values
    'page_size': 50,
    'sort_by': '-updated_at',
    'include_notes': 'true',
    'since': '2024-10-01T00:00:00Z'
}

response = requests.get(
    f'{API_URL}/activity/events/',
    headers=headers,
    params=params
)

if response.status_code == 200:
    data = response.json()
    print(f"Total: {data['count']} events")
    print(f"This page: {len(data['results'])} results")

    for event in data['results']:
        print(f"{event['serial_number']}: {event['title']} - {event['state']}")

    # Manual pagination
    while data.get('next'):
        print(f"Fetching next page...")
        response = requests.get(data['next'], headers=headers)
        data = response.json()
        for event in data['results']:
            print(f"{event['serial_number']}: {event['title']}")
else:
    print(f"Error {response.status_code}: {response.text}")

Using axios:

const axios = require('axios');

const API_URL = 'https://your-domain.pamdas.org/api/v1.0';
const TOKEN = 'YOUR_TOKEN_HERE';

async function listEvents() {
  try {
    const response = await axios.get(
      `${API_URL}/activity/events/`,
      {
        headers: {
          'Authorization': `Bearer ${TOKEN}`,
          'Accept': 'application/json'
        },
        params: {
          state: ['active', 'new'],  // Multiple values
          page_size: 50,
          sort_by: '-updated_at',
          include_notes: true,
          since: '2024-10-01T00:00:00Z'
        }
      }
    );

    console.log(`Total: ${response.data.count} events`);
    console.log(`This page: ${response.data.results.length} results`);

    response.data.results.forEach(event => {
      console.log(`${event.serial_number}: ${event.title || 'Untitled'} - ${event.state}`);
      if (event.location) {
        console.log(`  Location: ${event.location.latitude}, ${event.location.longitude}`);
      }
    });

    // Check for more pages
    if (response.data.next) {
      console.log('More results available');
    }

    return response.data;
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
    throw error;
  }
}

listEvents();

curl 'https://your-domain.pamdas.org/api/v1.0/activity/event/a1b2c3d4-e5f6-7890-abcd-ef1234567890/' \
  -H 'Authorization: Bearer YOUR_TOKEN_HERE' \
  -H 'Accept: application/json'

import requests

API_URL = 'https://your-domain.pamdas.org/api/v1.0'
TOKEN = 'YOUR_TOKEN_HERE'
EVENT_ID = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'

headers = {'Authorization': f'Bearer {TOKEN}'}

response = requests.get(
    f'{API_URL}/activity/event/{EVENT_ID}/',
    headers=headers
)

if response.status_code == 200:
    event = response.json()
    print(f"Event: {event['title']}")
    print(f"Type: {event['event_type']}")
    print(f"State: {event['state']}")
    print(f"Details: {event['event_details']}")
else:
    print(f"Error {response.status_code}: {response.text}")

const axios = require('axios');

const API_URL = 'https://your-domain.pamdas.org/api/v1.0';
const TOKEN = 'YOUR_TOKEN_HERE';
const EVENT_ID = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890';

async function getEvent(eventId) {
  try {
    const response = await axios.get(
      `${API_URL}/activity/event/${eventId}/`,
      {
        headers: {
          'Authorization': `Bearer ${TOKEN}`,
          'Accept': 'application/json'
        }
      }
    );

    console.log('Event:', response.data.title);
    console.log('Type:', response.data.event_type);
    console.log('State:', response.data.state);

    return response.data;
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
    throw error;
  }
}

getEvent(EVENT_ID);

curl -X POST 'https://your-domain.pamdas.org/api/v1.0/activity/events/' \
  -H 'Authorization: Bearer YOUR_TOKEN_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "event_type": "wildlife_sighting_rep",
    "time": "2024-10-19T14:30:00Z",
    "priority": 200,
    "location": {
      "latitude": -2.345678,
      "longitude": 34.567890
    },
    "title": "Elephant Herd Sighting",
    "event_details": {
      "species": "African Elephant",
      "number_of_individuals": 8,
      "behavior": "Drinking at waterhole",
      "age_group": "mixed"
    }
  }'

import requests
from datetime import datetime

API_URL = 'https://your-domain.pamdas.org/api/v1.0'
TOKEN = 'YOUR_TOKEN_HERE'

headers = {
    'Authorization': f'Bearer {TOKEN}',
    'Content-Type': 'application/json'
}

new_event = {
    'event_type': 'wildlife_sighting_rep',
    'time': datetime.utcnow().isoformat() + 'Z',
    'priority': 200,
    'location': {
        'latitude': -2.345678,
        'longitude': 34.567890
    },
    'title': 'Elephant Herd Sighting',
    'event_details': {
        'species': 'African Elephant',
        'number_of_individuals': 8,
        'behavior': 'Drinking at waterhole',
        'age_group': 'mixed'
    }
}

response = requests.post(
    f'{API_URL}/activity/events/',
    headers=headers,
    json=new_event
)

if response.status_code == 201:
    event = response.json()
    print(f"Created event ID: {event['id']}")
    print(f"Serial number: {event['serial_number']}")
else:
    print(f"Error {response.status_code}: {response.text}")

const axios = require('axios');

const API_URL = 'https://your-domain.pamdas.org/api/v1.0';
const TOKEN = 'YOUR_TOKEN_HERE';

async function createEvent() {
  const newEvent = {
    event_type: 'wildlife_sighting_rep',
    time: new Date().toISOString(),
    priority: 200,
    location: {
      latitude: -2.345678,
      longitude: 34.567890
    },
    title: 'Elephant Herd Sighting',
    event_details: {
      species: 'African Elephant',
      number_of_individuals: 8,
      behavior: 'Drinking at waterhole',
      age_group: 'mixed'
    }
  };

  try {
    const response = await axios.post(
      `${API_URL}/activity/events/`,
      newEvent,
      {
        headers: {
          'Authorization': `Bearer ${TOKEN}`,
          'Content-Type': 'application/json'
        }
      }
    );

    console.log('Created event ID:', response.data.id);
    console.log('Serial number:', response.data.serial_number);

    return response.data;
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
    throw error;
  }
}

createEvent();

curl -X GET "https://your-domain.pamdas.org/api/v2.0/activity/eventtypes/" \\
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \\
  -H "Accept: application/json"

import requests

API_URL = 'https://your-domain.pamdas.org/api/v2.0'
TOKEN = 'YOUR_TOKEN_HERE'

headers = {
    'Authorization': f'Bearer {TOKEN}',
    'Accept': 'application/json'
}

response = requests.get(f'{API_URL}/activity/eventtypes/', headers=headers)

if response.status_code == 200:
    data = response.json()
    for event_type in data['data']:
        print(f"{event_type['display']} ({event_type['value']})")
        print(f"  Category: {event_type['category']}")
        print(f"  Default Priority: {event_type['default_priority']}")
else:
    print(f"Error: {response.status_code}")
    print(response.text)

const axios = require('axios');

const API_URL = 'https://your-domain.pamdas.org/api/v2.0';
const TOKEN = 'YOUR_TOKEN_HERE';

async function listEventTypes() {
  try {
    const response = await axios.get(
      \`\${API_URL}/activity/eventtypes/\`,
      {
        headers: {
          'Authorization': \`Bearer \${TOKEN}\`,
          'Accept': 'application/json'
        }
      }
    );
    
    console.log('Event Types:');
    response.data.data.forEach(eventType => {
      console.log(\`\${eventType.display} (\${eventType.value})\`);
      console.log(\`  Category: \${eventType.category}\`);
    });
    
    return response.data;
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
    throw error;
  }
}

listEventTypes();