List transactions

GET /api/v1/integration/transactions

Returns the caller's CONFIRMED and EXTERNAL fuel transactions created within a date range, newest first, with cursor-based pagination. The customer account is derived from the API key.

Query parametersCopy Anchor Link

Pass several statuses as a comma-separated list, for example status=CONFIRMED,EXTERNAL.

Which transactions are returned?Copy Anchor Link

• Only CONFIRMED and EXTERNAL transactions. PENDING, VOID and CANCELED transactions are never returned. A transaction that is voided or canceled after you fetched it simply disappears from later results for the same range. See Detecting voids and cancellations.
• Refund transactions (for duplicates, variances or resolved disputes) are returned, with correction_reference_id pointing to the original transaction.
• Manual balance adjustments made by Octane's accountants are never returned.

Example requestCopy Anchor Link

curl -G "https://prod-app.octanetech-api.com/api/v1/integration/transactions" \
  -H "X-API-Key: $OCTANE_API_KEY" \
  --data-urlencode "from=2026-09-01T00:00:00Z" \
  --data-urlencode "to=2026-09-30T23:59:59Z" \
  --data-urlencode "corporate_id=67,68" \
  --data-urlencode "status=CONFIRMED" \
  --data-urlencode "limit=100"

Example responseCopy Anchor Link

{
  "data": [
    {
      "id": 185432,
      "status": "CONFIRMED",
      "created_at": "2026-09-20T08:59:36.340Z",
      "confirmed_at": "2026-09-20T09:00:02.110Z",
      "correction_reference_id": null,
      "corporate": { "id": 67, "name": "Acme Logistics" },
      "corporate_group": { "id": 9, "name": "Acme Group" },
      "fuel": {
        "type": { "id": 2, "name": "Benzine 92" },
        "liters": 18.5,
        "price_per_liter": 13.75,
        "amount": 254.38
      },
      "odometer_reading": 120450,
      "distance_traveled": 312,
      "fuel_consumption": 5.93,
      "station": {
        "id": 164,
        "name": "Misr Petroleum - Ring Road",
        "provider": { "id": 7, "name": "Misr Petroleum" },
        "is_external": false
      },
      "vehicle": {
        "id": 4,
        "code": "V-004",
        "number_plate": "ABC 1234",
        "chassis_number": "JTDBR32E720123456",
        "brand": "Toyota",
        "model": "Hilux",
        "year": 2021,
        "department": { "id": 3, "name": "Distribution" }
      },
      "driver": { "id": 31, "name": "Ahmed Mostafa" },
      "fees": {
        "total_fees": 1.06,
        "total_vat": 0.13,
        "total_amount": 255.435000
      },
      "images": {
        "pump": "https://storage.example/pump.jpg?X-Amz-Expires=3600&...",
        "odometer": "https://storage.example/odometer.jpg?X-Amz-Expires=3600&...",
        "expires_at": "2026-09-20T10:00:02Z"
      }
    }
  ],
  "pagination": {
    "limit": 100,
    "has_more": true,
    "next_cursor": "eyJ0IjoiMjAyNi0wOS0yMFQwODo1OTozNi4zNDBaIiwiaWQiOjE4NTQzMn0"
  }
}

Successful responses may also include the X-Access-Expires-At header. See Access expiry.

The transaction objectCopy Anchor Link

Top levelCopy Anchor Link

corporate and corporate_groupCopy Anchor Link

fuelCopy Anchor Link

stationCopy Anchor Link

vehicleCopy Anchor Link

driverCopy Anchor Link

The driver's email address is never returned.

feesCopy Anchor Link

The same three figures shown in the Octane dashboard's transactions table.

Fees are returned exactly as recorded on the transaction, for EXTERNAL transactions as well as CONFIRMED ones. A breakdown of individual fee types is not part of the API.

imagesCopy Anchor Link

Image URLs are presigned and expire after 1 hour. Download the images promptly if you need to keep them; do not store the URLs. Re-fetch the transaction to get fresh URLs.

External transactionsCopy Anchor Link

An EXTERNAL transaction was recorded at a station outside the Octane network. It has the same shape as a confirmed transaction, with these differences:

• status is EXTERNAL.
• station.is_external is true, station.id and station.provider are null, and station.name is the external station name.
• fees are returned as recorded, which may be zero or non-zero depending on your agreement.

Precision rulesCopy Anchor Link

ErrorsCopy Anchor Link

Plus the shared authentication and network errors. See Errors.