API Documentatie

    Integreer ReturnFlow in je eigen systemen via onze REST API. 31 endpoints beschikbaar.

    Authenticatie

    Alle requests vereisen een API-key in de Authorization header:

    Authorization: Bearer rf_live_jouw_api_key_hier

    API-keys kun je aanmaken via Instellingen → API in je dashboard.

    Rate Limiting

    Maximum 100 requests per minuut per API-key.

    De header X-RateLimit-Remaining toont het resterende aantal requests.

    Response Format

    {
  "success": true,
  "data": [...],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 234,
    "total_pages": 5
  },
  "meta": {
    "request_id": "req_abc123def4",
    "timestamp": "2026-02-23T15:00:00.000Z"
  }
}

    Endpoints

    GET
    /returns

    Alle retouren ophalen met filters op status en datum

    Parameters: status, from_date, to_date, page, per_page

    returns:read
    GET
    /returns/:id

    Details van een specifieke retour inclusief grading

    returns:read
    GET
    /returns/:id/grading

    Volledige grading details: sessies, foto's, completeness en addon resultaten

    returns:read
    GET
    /returns/:id/refund

    Refund goedkeuringsstatus van een retour

    returns:read
    GET
    /bol-returns

    Bol.com retouren met filters op status en datum

    Parameters: status, from_date, to_date, page, per_page

    returns:read
    GET
    /amazon-returns

    Amazon retouren met filters op status en datum

    Parameters: status, from_date, to_date, page, per_page

    returns:read
    GET
    /return-requests

    Retourverzoeken van consumenten

    Parameters: status, page, per_page

    returns:read
    GET
    /return-requests/:id

    Detail van een retourverzoek inclusief items

    returns:read

    GET
    /products

    Productcatalogus met prijzen

    Parameters: search, ean, brand, page, per_page

    products:read
    GET
    /products/:ean

    Product details per EAN

    products:read
    GET
    /products/:ean/returns

    Retourhistorie per product (EAN)

    Parameters: page, per_page

    products:read
    GET
    /products/:ean/grading

    Grading verdeling per product met sessie-details

    products:read

    Scopes

    returns:readRetouren, retourverzoeken en activiteitenlog inzien
    inventory:readVoorraad en doorverkoop-listings inzien
    products:readProducten, prijzen en storefront-feed inzien
    financials:readSettlements en ledger inzien
    orders:writeOrders importeren
    shipments:readZendingen inzien
    shipments:writeZendingen aanmelden
    webhooks:manageWebhooks aanmaken, inzien en verwijderen
    stats:readStatistieken en rapportages inzien

    Voorbeelden

    Retouren ophalen via POST body

    curl -X POST "https://lqhdtyxlkapgvfrpeytt.supabase.co/functions/v1/customer-api" \
  -H "Authorization: Bearer rf_live_jouw_key" \
  -H "Content-Type: application/json" \
  -d '{"endpoint": "GET /returns", "params": {"status": "received", "per_page": 10}}'

    Webhook registreren

    curl -X POST "https://lqhdtyxlkapgvfrpeytt.supabase.co/functions/v1/customer-api" \
  -H "Authorization: Bearer rf_live_jouw_key" \
  -H "Content-Type: application/json" \
  -d '{"endpoint": "POST /webhooks", "params": {"url": "https://jouw-site.nl/webhook", "events": ["return.created", "return.graded"]}}'

    Zending aanmelden

    curl -X POST "https://lqhdtyxlkapgvfrpeytt.supabase.co/functions/v1/customer-api" \
  -H "Authorization: Bearer rf_live_jouw_key" \
  -H "Content-Type: application/json" \
  -d '{"endpoint": "POST /shipments", "params": {"tracking_number": "3SPOST1234567", "carrier": "postnl", "expected_items": 25}}'

    Webhook Events

    Bij het registreren van een webhook ontvang je een secret. Gebruik dit om de HMAC-SHA256 signature in de X-Webhook-Signature header te verifiëren.

    return.createdNieuwe retour ontvangen in warehouse
    return.gradedRetour is beoordeeld met grade
    return.soldRetour is doorverkocht
    return.status_changedStatus van een retour is gewijzigd
    shipment.receivedInbound zending ontvangen
    settlement.createdNieuwe afrekening beschikbaar
    refund.approvedRefund goedgekeurd
    refund.rejectedRefund afgewezen

    WooCommerce Plugin

    Gebruik je WooCommerce? Download onze kant-en-klare WordPress plugin die automatisch verbindt met de ReturnFlow API.

    • Retourknop bij bestellingen in het klantaccount
    • Webhook endpoint voor statusupdates
    • Instellingenpagina onder WooCommerce menu
    • [returnflow_portal] shortcode
    Download de plugin →