Aller au contenu
Documentation développeursRéférence de l'APITâches

Lister les tâches

Les tâches de votre organisation, des plus récentes aux plus anciennes, page par page.

GEThttps://runner.cargoduo.com/v1/jobs

Authentification

Clé API Bearer avec l'autorisationjobs:readEn savoir plus

Paramètres de requête

NomTypeObligatoireDescription
limitinteger
integer
Non

Taille de page.

Par défaut 201–100
cursorstring
string
Non

next_cursor de la page précédente.

statusstring
string
Non

Uniquement les tâches ayant ce statut.

queuedrunningsucceededfailedcanceled

Exemple de requête

curl -X GET "https://runner.cargoduo.com/v1/jobs?limit=2&status=succeeded" \
  -H "Authorization: Bearer $CARGODUO_API_KEY"

Exemple de réponse

200 OK · JobList
{
  "data": [
    {
      "id": "job_4bK9mT2xQe7LpW1zRc8VdN3f",
      "object": "job",
      "status": "succeeded",
      "reference": "order-1042",
      "source": "api",
      "created_at": "2026-10-19T09:12:03Z",
      "started_at": "2026-10-19T09:12:03Z",
      "finished_at": "2026-10-19T09:12:07Z",
      "progress": {
        "stage": "done",
        "vehicles_done": 1,
        "placed_items": 58
      },
      "summary": {
        "items_requested": 58,
        "items_placed": 58,
        "items_unplaced": 0,
        "vehicles_used": 1,
        "total_weight": 8580,
        "volume_utilization": 0.3116,
        "queue_ms": 12,
        "compute_ms": 4210
      },
      "cost": {
        "credits": 0.28105,
        "reserved_credits": 1.11,
        "rate_card_version": 1,
        "breakdown": {
          "base": 0.06,
          "vehicles": 0.2,
          "compute": 0.02105,
          "large_load": 0
        }
      },
      "error": null,
      "warnings": [],
      "result_url": "https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result",
      "pdf_url": "https://app.cargoduo.com/r/Xq7Lm2Vt9KbR4cN8wZp1Hs6Yd3Fg5Jk0Ta2Ue7Wn4Ci",
      "expires_at": "2026-11-02T09:12:03Z"
    },
    {
      "id": "job_7hN2wQ5rTb9xKc3LmP8sVa1d",
      "object": "job",
      "status": "succeeded",
      "reference": "order-1039",
      "source": "api",
      "created_at": "2026-10-18T07:12:03Z",
      "started_at": "2026-10-18T07:12:03Z",
      "finished_at": "2026-10-18T07:12:05Z",
      "progress": {
        "stage": "done",
        "vehicles_done": 1,
        "placed_items": 24
      },
      "summary": {
        "items_requested": 24,
        "items_placed": 24,
        "items_unplaced": 0,
        "vehicles_used": 1,
        "total_weight": 6240,
        "volume_utilization": 0.2213,
        "queue_ms": 9,
        "compute_ms": 2870
      },
      "cost": {
        "credits": 0.27435,
        "reserved_credits": 1.11,
        "rate_card_version": 1,
        "breakdown": {
          "base": 0.06,
          "vehicles": 0.2,
          "compute": 0.01435,
          "large_load": 0
        }
      },
      "error": null,
      "warnings": [],
      "result_url": "https://runner.cargoduo.com/v1/jobs/job_7hN2wQ5rTb9xKc3LmP8sVa1d/result",
      "pdf_url": "https://app.cargoduo.com/r/Xq7Lm2Vt9KbR4cN8wZp1Hs6Yd3Fg5Jk0Ta2Ue7Wn4Ci",
      "expires_at": "2026-11-01T07:12:03Z"
    }
  ],
  "next_cursor": "job_7hN2wQ5rTb9xKc3LmP8sVa1d"
}

Réponses

  • 200OKUne page de tâches.
    NomTypeObligatoireDescription
    dataJob[]
    Job[]
    Non
    next_cursorstring
    string
    Non

    À passer dans ?cursor= pour obtenir la page suivante ; vide sur la dernière page.

  • 401Unauthorizedunauthorizedkey_revokedkey_expired
    • unauthorizedClé API absente, mal formée ou inconnue.
    • key_revokedLa clé a été révoquée.
    • key_expiredLa clé a dépassé sa date d'expiration.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur
  • 403Forbiddenip_not_allowedsubscription_inactiveaccount_inactivescope_missing
    • ip_not_allowedL'adresse IP appelante ne figure pas dans la liste des adresses IP autorisées de la clé.
    • subscription_inactiveL'organisation n'a aucun abonnement actif incluant l'API.
    • account_inactiveL'organisation est suspendue ou n'a aucun propriétaire dont le compte est actif.
    • scope_missingIl manque à la clé une autorisation requise par cet endpoint.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur
  • 422Unprocessable entityvalidation_failed
    • validation_failedLa requête est un JSON bien formé, mais décrit une tâche invalide. details[] liste tous les problèmes.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur
  • 429Too many requestsrate_limited
    • rate_limitedTrop de requêtes dans la minute, l'heure ou la journée en cours (par clé ou par organisation), ou plus de 60 échecs d'authentification par minute depuis votre adresse IP.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur
  • 500Internal server errorinternal_error
    • internal_errorUne erreur s'est produite de notre côté.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur
  • 503Service unavailableapi_disabled
    • api_disabledL'API est temporairement désactivée (maintenance) ou désactivée pour l'organisation.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur