Skip to content

FousPortTruckPass

Turn PortTruckPass into an API

Read My Containers, with each container's holds and fees due, and your reservations from PortTruckPass with one API call each. Or have a workflow check your import containers every weekday morning and email you the ones newly free of holds and fees.

Works with your own PortTruckPass account. Fous is an independent product.

What you can build on PortTruckPass

  • Get my containers

    Build this

    Reads the My Containers watchlist on the TIPS Containers page: each import or export container with its vessel, holds and fees.

    Takes
    Trade type (optional), container numbers (optional)
    Returns
    Container number, trade type, line, vessel name, voyage, unload date, line hold, custom hold, fee due, fee paid, last updated
  • Get my reservations

    Build this

    Reads the My Reservations page under Reservations: each visit's ticket number, terminal, move type, containers, truck plate and time slot.

    Takes
    Terminal (optional), date (optional), ticket or container number (optional)
    Returns
    Ticket number, terminal, move type, container or reference number, truck plate, reservation time
  • Get vessel schedule cutoffs

    Build this

    Reads the Vessel Schedule list view a terminal posts: each vessel's arrival, departure and cargo and reefer cutoffs.

    Takes
    Terminal, date range
    Returns
    Vessel name, voyage, ETA, ETD, ATA, ATD, First Av, St/Rcv, Cargo Cutoff, Reefer Cutoff
  • Add a single visit reservation

    Build this

    Opens Add Reservation in Single Visit view, enters the truck plate, move type and unit or reference number, picks a time slot from Find Reservation and submits.

    Takes
    Terminal, truck plate, move type, unit number or reference number, preferred time
    Returns
    Ticket number, terminal, move type, unit or reference number, reservation time

Automate PortTruckPass with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

  • Import containers free to pick, every weekday morning

    Build this
    Starts
    Every weekday at 6:00 New York time
    Step 1
    Get my containers with trade type Import from the My Containers watchlist.
    Step 2
    Keep the containers with no line hold, no custom hold and nothing in Fee Due.
    Step 3
    Keep the ones that were not free to pick on the last run.
    Step 4
    Email you the list grouped by line, with container number, vessel, voyage and unload date.
  • Holds and fees that changed, sent to your dispatch system

    Build this
    Starts
    Every hour
    Step 1
    Get my containers from the My Containers watchlist.
    Step 2
    Keep the containers whose line hold, custom hold or fee due changed since the last run.
    Step 3
    Post each one to your dispatch or TMS webhook.
  • Tomorrow's reservations, handed to dispatch

    Build this
    Starts
    Every weekday at 17:00 New York time
    Step 1
    For each terminal you name, get my reservations for the next day.
    Step 2
    Stop when there are none.
    Step 3
    Post ticket number, move type, container or reference number, truck plate and time to your dispatch webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get my containers” would look like.

Example request
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "porttruckpass.emodal.com/get_my_containers",
    "input": {
      "trade_type": "Import"
    }
  }'
Example response
{
  "status": "completed",
  "data": {
    "containers": [
      {
        "container_number": "ACMU4821736",
        "trade_type": "Import",
        "line": "Northwind Line",
        "vessel_name": "Northwind Harmony",
        "voyage": "112W",
        "unload_date": "2026-11-10",
        "line_hold": false,
        "custom_hold": false,
        "fee_due": 0,
        "fee_paid": 145,
        "last_updated": "2026-11-12T05:41:00-05:00"
      }
    ]
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

PortTruckPass’s own options

STS's support page for PortTruckPass lists APIs for cargo visibility and appointment setting among the TIPS features and points to eModal Data Services (EDS) through a request form. No PortTruckPass API reference, prices or terms are published. CargoSprint's public Data Services reference covers terminal metrics, such as appointment availability and container dwell.

OptionWhat it coversWhat it takes
eModal Data Services (EDS) APIsThe public reference lists terminals, appointment availability, container dwell time and appointment performance for a terminal.Asked for through the Learn More form on the PortTruckPass support page. Access terms and prices are not published.
Notifications and downloadsNotification subscriptions for Reservation Created, Reservation Change Status and Reservation Cancelled; watchlists download by email, PDF or Excel.A PortTruckPass account with access to the watchlist screens.
Create Pregate templateSeveral pregates at once: you download the template, fill it in and upload it on the Create Pregate screen.A PortTruckPass account allowed to create pregates.
PortTruckPass by handThe Containers, Bookings and Group Codes watchlists, reservations, Vessel Schedule, Export Claims and fee payment, at the six terminals of the port.A registered company, once approved, and a user with a unique email address in one of its security groups.

Read on November 12, 2026: PTP Support: next generation of PortTruckPass / TIPS, Data Services API overview, PTP user guide (Community Portal 2.0 resource guide).

Signing in to PortTruckPass

PortTruckPass signs each user in with their own email address and password. Since the 2021 upgrade, users who shared one email address each need their own, and your company administrator's security groups decide which screens a user sees. With Fous you sign in once through PortTruckPass's own sign-in with your own account: the login is sealed with AES-256, and an expired session is signed back in.

Worth knowing

One email address per user
Each user needs a unique email address linked to their account. Your company's administrator adds users and approves affiliation requests, and their security group and data access profile decide what they see.
Trucks and drivers are registered first
The truck registration service implements the Port Authority's subrules in FMC Schedule PA-10. A trucking company may need to register each driver and truck and link them, and a reservation asks for the truck plate.
Company approval comes before users
A trucking company registers with its SCAC code, US DOT number and motor carrier permit number, then waits for approval before it can set up security groups and add users.
Older reservations are read-only
Reservations made before the new appointment screens launched sit in Archived Reservation Moves and Visits, read-only and shown only to existing users.

More in Logistics: ocean carriers, terminals and ports

Other industries: One Network, Cummins Supplier Portal, LeShuttle Freight, Entrata, ASCAP Member Access, Rithum OrderStream.

Frequently asked questions

Not one with public documentation. The PortTruckPass support page lists APIs for cargo visibility and appointment setting and points to eModal Data Services through a request form, without published terms. CargoSprint's public Data Services reference covers terminal metrics such as appointment availability and container dwell.

PortTruckPass lists six terminals at the Port of New York and New Jersey: APM Terminals Port Elizabeth, Port Liberty Bayonne, Port Liberty New York, Maher Terminals, PNCT and Red Hook Terminals.

Add it to My Containers on the TIPS Containers page. The watchlist shows Line Hold, Custom Hold, Fee Due and Fee Paid for each container, and the Fees Due icon leads to Pay Now.

Yes. A PortTruckPass notification subscription takes a category (Container, Booking or Group Code) and a notification type: Reservation Created, Reservation Change Status or Reservation Cancelled.

No. Fous is an independent product. You use it with your own PortTruckPass account, and a method reads and does only what that account can.

Put PortTruckPass behind an API call

Describe one job in Studio and see the method it builds, with 100 credits a month and no credit card, or book a demo and bring the sites your team signs in to.

Read nextDAKOSYDestin8PortbaseOne NetworkHow methods workHow workflows run

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of PortTruckPass (Sustainable Terminal Services, Inc. (STS), on CargoSprint's eModal). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.