REST API

List all assets with optional filtering and pagination.

Query Parameters:

Example Request:

curl -X GET "https://tageur.com/api/assets?status=operational&page=1&per_page=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response:

{
  "success": true,
  "data": {
    "assets": [
      {
        "id": 123,
        "name": "Excavator CAT 320",
        "asset_type": "Heavy Equipment",
        "status": "operational",
        "brand": "Caterpillar",
        "model_number": "320 GC",
        "serial_number": "CAT320GC2024001",
        "location": "Site A - Zone 3",
        "created_at": "2024-11-20T10:30:00Z",
        "updated_at": "2025-01-02T14:22:00Z"
      }
    ],
    "pagination": {
      "current_page": 1,
      "total_pages": 5,
      "total_count": 247,
      "per_page": 50
    }
  }
}

Retrieve detailed information about a specific asset.

Example Response:

{
  "success": true,
  "data": {
    "asset": {
      "id": 123,
      "name": "Excavator CAT 320",
      "asset_type": "Heavy Equipment",
      "status": "operational",
      "serial_number": "CAT320GC2024001",
      "brand": "Caterpillar",
      "model_number": "320 GC",
      "location": "Site A - Zone 3",
      "company_office_location_id": 45,
      "company_office_location": {
        "id": 45,
        "name": "Main Warehouse",
        "city": "Chicago",
        "state": "IL",
        "is_primary": true
      },
      "latitude": 40.7128,
      "longitude": -74.0060,
      "purchase_date": "2024-11-15",
      "purchase_price": "250000.00",
      "warranty_duration_months": 36,
      "warranty_expiry_date": "2027-11-15",
      "maintenance_enabled": true,
      "maintenance_interval_days": 180,
      "maintenance_status": "current",
      "last_maintenance_date": "2024-12-01",
      "next_maintenance_date": "2025-05-30",
      "extra_values": {
        "department": "Construction",
        "cost_center": "CC-450"
      },
      "company_id": 456
    }
  }
}

Create a new asset.

Required Fields:

• name - Asset name
• asset_type - Type category
• status - Current status

Example Request:

curl -X POST "https://tageur.com/api/assets" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "asset": {
      "name": "Forklift Toyota 8FG25",
      "asset_type": "Material Handling",
      "status": "operational",
      "brand": "Toyota",
      "model_number": "8FG25",
      "serial_number": "TY8FG2025001",
      "location": "Warehouse B",
      "company_office_location_id": 45,
      "purchase_date": "2025-01-03",
      "purchase_price": "28500.00",
      "extra_values": {
        "max_capacity": "5000 lbs",
        "fuel_type": "LPG"
      }
    }
  }'

Update an existing asset. Only include fields you want to change.

curl -X PATCH "https://tageur.com/api/assets/123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "asset": {
      "status": "maintenance",
      "location": "Maintenance Bay 2"
    }
  }'

Bulk create or update assets. Matches by serial_number - creates new or updates existing.

curl -X POST "https://tageur.com/api/assets/sync" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assets": [
      {
        "name": "Asset 1",
        "serial_number": "SN001",
        "asset_type": "Equipment",
        "status": "operational"
      },
      {
        "name": "Asset 2",
        "serial_number": "SN002",
        "asset_type": "Vehicle",
        "status": "operational"
      }
    ]
  }'

Response:

{
  "success": true,
  "message": "Sync completed: 15 created, 8 updated, 2 failed",
  "data": {
    "created": [
      { "id": 789, "serial_number": "SN015" }
    ],
    "updated": [
      { "id": 123, "serial_number": "SN002" }
    ],
    "failed": [
      {
        "serial_number": "SN099",
        "errors": ["Name can't be blank"]
      }
    ]
  }
}

Query Parameters:

curl -X POST "https://tageur.com/api/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": {
      "title": "Monthly Hydraulic Fluid Check",
      "description": "Inspect and top up hydraulic fluid levels",
      "status": "pending",
      "priority": "high",
      "asset_id": 123,
      "due_date": "2025-02-01",
      "estimated_hours": 2
    }
  }'

Task Action Endpoints:

Authentication (JWT)

Teams

Manage teams for task assignment and collaboration.

Create and manage shipments, assign assets, track delivery, and perform bulk claims. Available on Growth and Enterprise plans.

Company Members

View company members for task assignments.

Audit Trails

Track all changes to assets and tasks.

Document Signatures

Digital signatures for compliance documents.

Bulk REST API Sync (Recommended for Initial Loads)

Best for batch operations, initial data migration, and periodic syncs.

Available Sync Endpoints:

Event-Based Webhooks (Real-Time Updates)

Best for real-time, event-driven updates from external systems.

Webhook Endpoint:

Supported Events:

HTTP Status Codes:

Error Response Format:

{
  "success": false,
  "error": "Validation Failed",
  "errors": [
    "Name can't be blank",
    "Serial number has already been taken"
  ]
}

Sync Assets from ERP System

import requests
import os

TAGEUR_API_KEY = os.environ['TAGEUR_API_KEY']
BASE_URL = 'https://tageur.com/api'

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

# Fetch assets from your ERP
erp_assets = get_assets_from_erp()

# Prepare bulk sync payload
sync_payload = {
    'assets': [
        {
            'name': asset['name'],
            'serial_number': asset['serial'],
            'asset_type': asset['category'],
            'status': 'operational',
            'purchase_date': asset['purchase_date'],
            'location': asset['location']
        }
        for asset in erp_assets
    ]
}

# Sync to Tageur
response = requests.post(
    f'{BASE_URL}/assets/sync',
    headers=headers,
    json=sync_payload
)

result = response.json()
print(f"Synced: {len(result['data']['created'])} created, {len(result['data']['updated'])} updated")

Create Maintenance Tasks from Work Orders

const axios = require('axios');

const tageurApi = axios.create({
  baseURL: 'https://tageur.com/api',
  headers: {
    'Authorization': `Bearer ${process.env.TAGEUR_API_KEY}`,
    'Content-Type': 'application/json'
  }
});

// Convert work order to Tageur task
async function createMaintenanceTask(workOrder) {
  const taskData = {
    task: {
      title: workOrder.description,
      priority: mapPriority(workOrder.urgency),
      status: 'pending',
      asset_id: workOrder.equipment_id,
      due_date: workOrder.scheduled_date,
      estimated_hours: workOrder.estimated_duration,
      description: workOrder.notes
    }
  };

  try {
    const response = await tageurApi.post('/tasks', taskData);
    console.log('Task created:', response.data.data.task.id);
    return response.data.data.task;
  } catch (error) {
    console.error('Error creating task:', error.response.data);
    throw error;
  }
}

Export Asset Data for Reporting

require 'httparty'
require 'csv'

class TageurExporter
  API_KEY = ENV['TAGEUR_API_KEY']
  BASE_URL = 'https://tageur.com/api'

  def export_assets_to_csv(filename)
    all_assets = fetch_all_assets

    CSV.open(filename, 'wb') do |csv|
      csv << ['ID', 'Name', 'Type', 'Status', 'Serial', 'Location', 'Last Maintenance']

      all_assets.each do |asset|
        csv << [
          asset['id'],
          asset['name'],
          asset['asset_type'],
          asset['status'],
          asset['serial_number'],
          asset['location'],
          asset['last_maintenance_date']
        ]
      end
    end

    puts "Exported #{all_assets.size} assets to #{filename}"
  end

  private

  def fetch_all_assets
    assets = []
    page = 1

    loop do
      response = HTTParty.get(
        "#{BASE_URL}/assets",
        headers: { 'Authorization' => "Bearer #{API_KEY}" },
        query: { page: page, per_page: 100 }
      )

      data = response.parsed_response['data']
      assets.concat(data['assets'])

      break if data['pagination']['current_page'] >= data['pagination']['total_pages']
      page += 1
    end

    assets
  end
end

# Usage
exporter = TageurExporter.new
exporter.export_assets_to_csv('assets_report.csv')