Consulter l'activité récente d'un client par code

GET

/api/customers/{code}/recent-activity

Retourne la chronologie paginée des transactions et des paiements d'un client, à partir de son code client. Disponible aussi par identifiant interne via /by-id/{customer_id}/recent-activity. Les factures, crédits, autres transactions et paiements non archivés des lookback_months derniers mois (12 par défaut) sont listés du plus récent au plus ancien, chacun avec un montant signé (débit moins crédit) et un lien vers sa fiche. Les compteurs de summary portent sur toute la fenêtre, pas seulement sur la page. Paginez avec limit et offset en reprenant metadata.next_offset ou _links.next (null sur la dernière page) ; line_index reste la position globale d'une page à l'autre. Conventions communes (cache de 4 h, force_refresh, _links, metadata) : voir la présentation de la section Tableaux de bord.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Query Params

Responses

🟢200

application/json

Activité récente du client

Bodyapplication/json

🟠400

🟠401

🟠404

🟠409

🟠422

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://relay.exostack.cloud//api/customers//recent-activity?lookback_months=&limit=&offset=&force_refresh=' \
--header 'x-api-key: <api-key>'

Response Example

{
    "customer": {
        "id": 105,
        "code": "10005",
        "name": "Construction Exemple inc."
    },
    "lookback": {
        "months": 12,
        "from": "2025-10-07",
        "to": "2026-10-07"
    },
    "summary": {
        "total_events": 47,
        "invoices_count": 18,
        "credits_count": 5,
        "deposits_count": 2,
        "other_count": 0,
        "payments_count": 22,
        "limit_applied": 20,
        "truncated": true
    },
    "items": [
        {
            "line_index": 1,
            "event_date": "2026-09-28",
            "transaction_type": {
                "id": 3,
                "code": "invoice",
                "label": "Facture"
            },
            "source": {
                "kind": "invoice_ar",
                "id": 2287,
                "code": "24518"
            },
            "reference": "PO-88810",
            "description": "Rénovation cuisine",
            "due_date": "2026-10-28",
            "debit": 5370,
            "credit": 0,
            "amount_signed": 5370,
            "amount_remaining": 5370,
            "is_current_day": false,
            "is_paid_in_full": false,
            "_links": {
                "detail": "/api/customers/invoice-ar/by-id/2287"
            }
        },
        {
            "line_index": 2,
            "event_date": "2026-09-15",
            "transaction_type": {
                "id": 1,
                "code": "payment",
                "label": "Paiement"
            },
            "source": {
                "kind": "customer_payment",
                "id": 6120,
                "code": "4471"
            },
            "reference": "Chèque 3381",
            "debit": 0,
            "credit": 2414.48,
            "amount_signed": -2414.48,
            "is_current_day": false,
            "_links": {
                "detail": "/api/customers/payments/by-id/6120"
            }
        }
    ],
    "metadata": {
        "organisation_id": "construction_demo",
        "extracted_at": "2026-10-07T14:06:06-04:00",
        "sdk_indexes_used": {
            "invoice_ar": 6,
            "customer_payment": 8
        },
        "scope": "non_archived_only",
        "ordering": "event_date_desc",
        "limit_applied": 20,
        "offset_applied": 0,
        "has_more": true,
        "next_offset": 20
    },
    "cache": {
        "status": "miss",
        "key_hash": "sha1:8d2e4b6a1c3f5e7d9b0a2c4e6f8a1b3d5c7e9f0a",
        "cached_at": "2026-10-07T14:06:06-04:00",
        "expires_at": "2026-10-07T18:06:06-04:00",
        "age_seconds": 0,
        "ttl_remaining_seconds": 14400,
        "ttl_policy": "current_period_4h",
        "force_refreshed": false
    },
    "_links": {
        "self": "/api/customers/by-id/105/recent-activity?lookback_months=12&limit=20&offset=0",
        "next": "/api/customers/by-id/105/recent-activity?lookback_months=12&limit=20&offset=20",
        "customer_overview": "/api/customers/by-id/105/overview",
        "customer_statement": "/api/customers/by-id/105/statement?from=2025-10-07&to=2026-10-07",
        "unpaid_invoices": "/api/customers/by-id/105/unpaid-invoices",
        "customer_aging": "/api/customers/aging/by-id/105"
    }
}

Modified at 2026-10-10 14:01:59

Consulter l'activité récente d'un client par ID

Lister les factures réglées par un paiement fournisseur