API v1

    Developer Documentation

    Build custom integrations with the Kaldr Tech REST API. Manage customers, jobs, invoices, and payments programmatically.

    Base URL: https://api.kaldrtech.com/v1Bearer token auth100 req/min rate limit

    Authentication

    All API requests require a Bearer token in the Authorization header. Generate your API key from the Portal under Settings > API Access.

    bash
    curl -X GET "https://api.kaldrtech.com/v1/customers" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json"

    Resources

    Customers

    Create, read, update, and manage customer records.

    GET
    /api/v1/customers

    List all customers with pagination and filtering

    POST
    /api/v1/customers

    Create a new customer record

    GET
    /api/v1/customers/:id

    Retrieve a specific customer by ID

    PATCH
    /api/v1/customers/:id

    Update customer details

    DELETE
    /api/v1/customers/:id

    Delete a customer record

    Example Request

    bash
    curl -X POST "https://api.kaldrtech.com/v1/customers" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "name": "John Smith",
        "email": "john@example.com",
        "phone": "+15551234567",
        "address": {
          "street": "123 Main St",
          "city": "Phoenix",
          "state": "AZ",
          "zip": "85001"
        },
        "notes": "Referred by Mike. Has two AC units."
      }'

    SDKs

    Official client libraries for popular languages.

    JavaScript / TypeScriptnpm install @kaldr/sdk
    Pythonpip install kaldr
    Gogo get github.com/kaldrtech/kaldr-go
    PHPcomposer require kaldr/kaldr-php

    Rate Limits & Errors

    Rate Limits

    • 100 requests per minute (free tier)
    • 1,000 requests per minute (growth tier)
    • Rate limit headers included in every response

    HTTP Status Codes

    200Success
    201Created
    400Bad request
    401Unauthorized
    404Not found
    429Rate limited
    500Server error

    Ready to build?

    Create your free Kaldr Tech account and generate an API key in under 5 minutes. Full access, no restrictions.