Porter Driver Partner App data API: earnings, invoices, TDS

SmartShift Logistics Solutions Private Limited · Transport

The Porter Driver Partner App is the driver-facing half of Porter's on-demand goods logistics network, and everything a partner earns or is paid flows through a private partner API. The home earnings card reads /v1/earnings/today; the weekly earning-transparency screen loads /v1/earnings/weekly-report with start and end dates. Payout invoices come from /v1/payouts/invoices and /v1/payouts/invoices/{invoice_id}, trip-level tax deducted at source from /v1/tax/withholding, and cash collection from /v1/wallet/collections. Every call carries a Bearer token from the OTP login session. Paths are illustrative; field names reflect the app's own models.

Porter Driver Partner App is the companion for driver-partners on Porter, India's on-demand goods logistics network (bikes, tempos, Ace and trucks). Behind the home earnings card, weekly earning-transparency screens, invoice list and wallet sits a private partner API: today's trip earnings, a dated weekly earning report with login minutes and completed trips, monthly payout invoices with billed vs settled amounts, per-order TDS deductions, and Muneemji wallet recharges used to collect cash from the partner. Calls run over a Bearer session issued after OTP login; the endpoints shown here are illustrative, field-faithful sketches of that interface.

Screenshots

API surface

Today's driver earnings
GET /v1/earnings/today openfinance
Returns the partner's earnings for the current day plus the running total including credit transactions — the home-screen earnings card.
Auth: Bearer token from OTP login session (Authorization header)
- today_earning
- total_earnings_with_credit_txns
Illustrative example reconstructed from the app's interface — not a live capture.
```
GET /v1/earnings/today HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "today_earning": 1840.5,
  "total_earnings_with_credit_txns": 2215.0
}
```
Derived from the app's interface; endpoint details are illustrative, not a live capture.
- reconstructed from the app's home-screen earnings card flow
- field names match the daily-earnings model backing that card

Weekly earning report

GET /v1/earnings/weekly-report openfinance

Loads the earning-transparency / weekly-earnings screens: per-week totals, login minutes, completed trips and a day-by-day work-unit breakdown.

Auth: Bearer token from OTP login session (Authorization header)

weekly_earning_reports
offset_week
weekly_summary
total_earnings
num_login_minutes
num_trips_completed
start_date
end_date
daily_earning_reports
date
daily_summary
work_unit_earning_reports

Illustrative example reconstructed from the app's interface — not a live capture.

GET /v1/earnings/weekly-report?start_date=2026-09-14&end_date=2026-09-20&type=WEEKLY HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "weekly_earning_reports": [
    {
      "weekly_summary": {
        "total_earnings": 12840.0,
        "num_login_minutes": 2460,
        "num_trips_completed": 37,
        "start_date": "2026-09-14",
        "end_date": "2026-09-20"
      },
      "daily_earning_reports": [
        {
          "date": "2026-09-18",
          "daily_summary": {
            "total_earnings": 2140.0,
            "num_login_minutes": 420,
            "num_trips_completed": 6,
            "date": "2026-09-18"
          },
          "work_unit_earning_reports": []
        }
      ]
    }
  ],
  "offset_week": "2026-09-14"
}

Derived from the app's interface; endpoint details are illustrative, not a live capture.

reconstructed from the app's weekly earning-transparency screen
mirrors the dated week-summary and day-by-day breakdown models

List payout invoices
GET /v1/payouts/invoices openfinance
Lists the partner's monthly payout invoices (invoice number, month, year) and the years that have invoices, feeding the invoice-list screen.
Auth: Bearer token from OTP login session (Authorization header)
- status
- result
- invoices_list
- years_list
- invoice_number
- month
- year
Illustrative example reconstructed from the app's interface — not a live capture.
```
GET /v1/payouts/invoices?year=2026&month=8 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "status": "ok",
  "result": {
    "invoices_list": [
      {"invoice_number": "INV-2026-08-44102", "month": 8, "year": 2026}
    ],
    "years_list": [2026, 2025]
  }
}
```
Derived from the app's interface; endpoint details are illustrative, not a live capture.
- reconstructed from the app's invoice-list screen and its year/month filters
Get invoice settlement detail
GET /v1/payouts/invoices/{invoice_id} openfinance
Returns one payout invoice's billed amount, platform fees, VAT, other levies, net settlement, completed-trip count and a PDF URI for download.
Auth: Bearer token from OTP login session (Authorization header)
- other_levies_debited
- porter_platform_fees
- vat
- other_levies_credited
- total_billed_amount
- total_settlement
- total_completed_trips
- pdf_uri
Illustrative example reconstructed from the app's interface — not a live capture.
```
GET /v1/payouts/invoices/INV-2026-08-44102 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "other_levies_debited": 120.0,
  "porter_platform_fees": 980.5,
  "vat": 176.49,
  "other_levies_credited": 40.0,
  "total_billed_amount": 14820.0,
  "total_settlement": 13583.01,
  "total_completed_trips": 142,
  "pdf_uri": "/media/invoices/INV-2026-08-44102.pdf"
}
```
Derived from the app's interface; endpoint details are illustrative, not a live capture.
- reconstructed from the invoice detail sheet opened from the invoice list
- settlement fields match the billed-vs-settled breakdown the app renders
Partner TDS tax deduction
GET /v1/tax/withholding openfinance
Looks up the tax deducted at source on a partner's order (rate, amount, status and explainer copy) for the wallet TDS banner and trip settlement UI.
Auth: Bearer token from OTP login session (Authorization header)
- tds_deduction_response
- timestamp
- order_id
- partner_earnings
- tds_applicable_percent
- tds_amount
- status
- info_message
- info_message_subtext
- content
- know_more_video
Illustrative example reconstructed from the app's interface — not a live capture.
```
GET /v1/tax/withholding?order_crn=CRN-9f2a1c&partner_uuid=drv_7c81 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "tds_deduction_response": {
    "timestamp": "2026-09-18T14:22:01Z",
    "order_id": "CRN-9f2a1c",
    "partner_earnings": 640.0,
    "tds_applicable_percent": 1.0,
    "tds_amount": 6.4,
    "status": "DEDUCTED",
    "info_message": "TDS deducted on this trip",
    "info_message_subtext": "As per IT Act section 194C",
    "content": {
      "reduction_banner": {"enabled": true}
    },
    "know_more_video": {"url": "/media/tds/know-more.mp4"}
  }
}
```
Derived from the app's interface; endpoint details are illustrative, not a live capture.
- reconstructed from the wallet TDS banner and trip settlement screens
- per-order lookup keyed by the order reference and the partner id
Create Muneemji wallet recharge
POST /v1/wallet/collections openfinance
Starts a Muneemji (cash-collection) recharge against the partner wallet so Porter can collect outstanding cash; returns the recharge state used by the payment flow.
Auth: Bearer token from OTP login session (Authorization header)
- driver_uuid
- amount_rs
- initiated_at
- uuid
- type
- success
- muneemji_recharge
- state
- status
- error_code
- wallet_version_id
Illustrative example reconstructed from the app's interface — not a live capture.
```
POST /v1/wallet/collections?wallet_version_id=3 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "driver_uuid": "drv_7c81",
  "amount_rs": 500.0,
  "initiated_at": 1758614400,
  "uuid": "mj_recharge_01H9",
  "type": "COLLECT"
}
```
```
{
  "success": true,
  "muneemji_recharge": {
    "driver_uuid": "drv_7c81",
    "amount_rs": 500.0,
    "initiated_at": 1758614400,
    "state": "Initiated"
  },
  "status": 200,
  "error_code": null
}
```
Derived from the app's interface; endpoint details are illustrative, not a live capture.
- reconstructed from the wallet cash-collection (Muneemji) payment flow
- create-and-track shape: the response carries the new recharge state

Data categories

earnings
invoices
payouts
tax
wallet

Where teams use this data

Driver tax filing
Tax apps pull the per-order TDS withholding — applicable percent, deducted amount, order id — into quarterly filings, so drivers stop reconstructing deductions from screenshots.
Settlement accounting
Bookkeeping integrations import payout invoices and settlement detail (platform fees, VAT, total settlement, trip counts), reconciling what Porter billed against what the driver received.
Fleet earnings analytics
Fleet managers read today's earnings and the weekly report — trips completed, login minutes, daily breakdowns — to coach drivers on utilization, not just revenue.

Frequently asked questions

What earnings data does the Porter partner app expose?

The home card calls /v1/earnings/today for today_earning and total_earnings_with_credit_txns. The weekly screen calls /v1/earnings/weekly-report and returns weekly_summary totals (total_earnings, num_login_minutes, num_trips_completed, start_date, end_date) plus daily_earning_reports with work_unit_earning_reports.

How are partner payout invoices structured?

/v1/payouts/invoices?year=&month= returns invoices_list entries with invoice_number, month and year. /v1/payouts/invoices/{invoice_id} then returns total_billed_amount, porter_platform_fees, vat, other levies, total_settlement, total_completed_trips and a pdf_uri.

Does the app surface tax deducted at source?

Yes. GET /v1/tax/withholding?order_crn=&partner_uuid= returns tds_deduction_response with partner_earnings, tds_applicable_percent, tds_amount and status for the wallet TDS banner.

How does wallet cash collection work?

POST /v1/wallet/collections with driver_uuid, amount_rs, initiated_at, uuid and type creates a Muneemji recharge. The response carries success, muneemji_recharge.state and an optional error_code.

Related apps

Topics

Porter Driver Partner App API
Porter partner earnings API
driver earnings endpoint
weekly earning report API
Porter invoice payout
Porter TDS tax deduction
Muneemji wallet recharge
Porter partner gateway
SmartShift logistics driver data

Need this app's data API integrated?

We deliver scoped integrations for any named app — from USD 500 with source-code handoff, or hosted access billed per call. Tell us the data you need.

Get a quote

Porter Driver Partner App data API: earnings, invoices, TDS

Screenshots

API surface

Today's driver earnings

Weekly earning report

List payout invoices

Get invoice settlement detail

Partner TDS tax deduction

Create Muneemji wallet recharge

Data categories

Where teams use this data

Driver tax filing

Settlement accounting

Fleet earnings analytics

Frequently asked questions

Related apps

Topics

Need this app's data API integrated?