LynxoLynxo Docs

Get Jobs

Retrieve a list of jobs with optional filtering and pagination.

Notes:

  • All query parameters are optional.
  • page defaults to 1 if not provided.
  • timestamp_from and timestamp_to are in epoch seconds.
  • branch_id and team_id are string values.
  • status is an integer value.

Parameters

page
integer
Page number for pagination (default: 1).
timestamp_from
integer
Start timestamp filter in epoch format.
timestamp_to
integer
End timestamp filter in epoch format.
branch_id
string
Filter jobs by branch ID.
team_id
string
Filter jobs by team ID.
status
integer
Filter jobs by status.
GET/v1/jobs
curl https://api.lynxo.ai/v1/jobs \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR....." \
  -H "Content-Type: application/json" \
  -d '{"page":1,"timestamp_from":1754245800,"timestamp_to":1754332199,"branch_id":"MAA","team_id":"23","status":1}'
RESPONSE
{
  "jobs": [
    {
      "id": 5360530,
      "order_id": "887121212",
      "type": "pickup_delivery",
      "status": 2,
      "notes": "Handle with care",
      "created_at": 1754286355,
      "updated_at": 1754674140,
      "rider": {
        "id": 2784742,
        "reference_id": "RR2784742",
        "name": "Shaik Zaheeruddin",
        "username": "szaheeruddin1",
        "dial_code": "",
        "mobile": "",
        "email": "yixog17429@blaxion.com",
        "type": "rider",
        "status": 1,
        "profile_pic": "",
        "email_verified": false,
        "phone_verified": false,
        "metadata": {},
        "last_coordinates": {
          "longitude": null,
          "latitude": null
        },
        "created_at": 1754670940,
        "updated_at": 1754672575
      },
      "pickups": [
        {
          "id": 29,
          "status": 1,
          "pickup_slot_from": 1754332920,
          "pickup_slot_to": 1754376120,
          "created_at": 1754286355,
          "updated_at": 1754286355,
          "address": null,
          "customer": null,
          "branch": {
            "id": "MAAA",
            "name": "Chennai",
            "time_zone": "",
            "contacts": [
              {
                "name": "Ul",
                "phone": "723482932",
                "work_timings": {
                  "from": "09:00 AM",
                  "to": "05:00 PM"
                },
                "work_days": [
                  "monday",
                  "tuesday",
                  "wednesday",
                  "thursday",
                  "friday"
                ]
              }
            ],
            "formatted_address": "Neelakanta Mehta Street, Parthasarathy Puram, 600017, T Nagar, Chennai, Chennai, Tamil Nadu, India",
            "active": true,
            "delivery_zones": null,
            "coordinates": {
              "longitude": 80.240281,
              "latitude": 13.037106
            },
            "created_at": 1752077103,
            "updated_at": 1754380833,
            "created_by": {
              "user_type": "iam",
              "user_id": "42",
              "user_name": "Best"
            },
            "updated_by": {
              "user_type": "iam",
              "user_id": "42",
              "user_name": "Best Account"
            }
          },
          "next_status": [
            2,
            5,
            6
          ],
          "in_progress": false,
          "completed": false,
          "packages": [
            {
              "package_id": "PKG001",
              "barcode": "BR001"
            }
          ],
          "status_history": []
        }
      ],
      "deliveries": [
        {
          "id": 27,
          "status": 1,
          "first_order": false,
          "enable_otp": false,
          "otp": "",
          "note": "",
          "unattended_delivery": false,
          "leave_at_door": false,
          "dont_ring_bell": false,
          "age_restricted_delivery": false,
          "signature_required": false,
          "signature_image": "",
          "proof_of_delivery_images": [],
          "payment_type": 2,
          "amount": 100,
          "tracking_id": "42-3030-ZJZ",
          "delivery_slot_from": 1754419440,
          "delivery_slot_to": 1754419440,
          "created_at": 1754286355,
          "updated_at": 1754286355,
          "address": null,
          "customer": null,
          "branch": {
            "id": "MAAA",
            "name": "Chennai",
            "time_zone": "",
            "contacts": [
              {
                "name": "Ul",
                "phone": "723482932",
                "work_timings": {
                  "from": "09:00 AM",
                  "to": "05:00 PM"
                },
                "work_days": [
                  "monday",
                  "tuesday",
                  "wednesday",
                  "thursday",
                  "friday"
                ]
              }
            ],
            "formatted_address": "Neelakanta Mehta Street, Parthasarathy Puram, 600017, T Nagar, Chennai, Chennai, Tamil Nadu, India",
            "active": true,
            "delivery_zones": null,
            "coordinates": {
              "longitude": 80.240281,
              "latitude": 13.037106
            },
            "created_at": 1752077103,
            "updated_at": 1754380833,
            "created_by": {
              "user_type": "iam",
              "user_id": "42",
              "user_name": "Best"
            },
            "updated_by": {
              "user_type": "iam",
              "user_id": "42",
              "user_name": "Best Account"
            }
          },
          "next_status": [
            2,
            5,
            6
          ],
          "in_progress": false,
          "completed": false,
          "packages": [
            {
              "package_id": "PKG001",
              "barcode": "BR001"
            }
          ],
          "status_history": []
        }
      ],
      "status_history": [
        {
          "status": 1,
          "remarks": "",
          "created_by": {
            "user_type": "iam",
            "user_id": "42",
            "user_name": "Best Account"
          },
          "created_at": 1754286355
        },
        {
          "status": 2,
          "remarks": "",
          "created_by": {
            "user_type": "iam",
            "user_id": "42",
            "user_name": "Best Account"
          },
          "created_at": 1754674140
        }
      ],
      "next_status": [
        3,
        5,
        7
      ]
    }
  ],
  "total_records": 1,
  "page": 1,
  "total_pages": 1
}