This page is created to help you navigate Mobility APIs.
B2B Mobility Card Management
This API includes endpoints for handling Shell fuel cards. It contains following operations: search for shell fuel cards, ordering fuel card, sending pin reminders, updating fuel card status (blocking permanently, temporarily or unblocking), view status of card order, scheduling card block / unblock requests, allow or prohibit card reissue, update the card’s delivery addresses, move cards between accounts and card groups, webhook notifications for card order and update status.
Card Management APIs exists in two versions with OAuth 2.0 authentication and Card Management APIs with Basic Authentication. Card Management APIs with Basic Authentication are sunsetting. Use Card Management APIs with OAuth 2.0 authentication
B2B Mobility Card Pin Management
This API is essentials for card orders with self selected pin. It includes two endpoints, for public key retreival that is used to encrypt data for selected PIN and an endpoint to validate pin.
Validate PIN endpoints exists only in Sandbox environment. Use it to verify the correctness of encryption implementation before moving to production.
B2B Mobility Card Transaction Data
This API contains endpoints to retrieve transactions(sales items) and fees (fee items) from Shell system: transactions summaries (by invoice status, date, period, date range, account, card etc),retrieves the active bonus and association bonus rules, retrieve a summary of fee items.
Card Transaction Data APIs exists in two versions with OAuth 2.0 authentication and Card Transaction Data with Basic Authentication. Card Transaction Data with Basic Authentication is sunsetting. Use Card Transaction Data with OAuth 2.0 authentication
B2B Mobility Card Recent Transaction
It is a premium feature, contains an endpoint for querying last 48 hours of transaction data of Shell Card (i.e. Priced, Billed, Unbilled etc. sales items). It provides a flexible search criteria and supports pagination.
B2B Mobility Limit and Restriction
This API allows operations like: querying card details including the day/time and product restrictions, set or update the restrictions for existing cards or newly ordered cards, create a new card bundle and apply restrictions, update card bundles, delete bundles, retrieve summary of bundles(restriction profiles).
The total number of cards in a bundle must be 500 or less
B2B Mobility Customer Data
This API allows querging customer account details, API user data via /loggedinuser (payer access), Accounts under a payer, card groups, create new card group, updating or removing card group, fetch International and National Price List, fetch historical requests of account or card operations performed by users of a given customer, fetching active card types.
Customer Data APIs exists in two versions with OAuth 2.0 authentication and Customer Data with Basic Authentication. Customer Data with Basic Authentication is sunsetting. Use Customer Data with OAuth 2.0 authentication
B2B Mobility Invoice
This API contains endpoints that allow to search invoice data in the Shell Card Platform, retreive high level summary of invoices, querying the details of the latest statement of account (SOA), retrieve the list of invoices for the given date range, querying the details of all invoices and file reference numbers for downloading, retrieve a list of EIDs, download invoices and EIDs.
Invoice APIs exists in two versions with OAuth 2.0 authentication and Invoice with Basic Authentication. Invoice with Basic Authentication is sunsetting. Use Invoice with OAuth 2.0 authentication
B2B Mobility Sites
B2B Mobility Sites provides the complete list of all Shell location. The list includes all Shell network and all locations available through our roaming partners.
Shell SmartPay API/Shell Digital Payment
This API allows to digitalize Shell fuel card and pay for fuel directly at the forecourt. With this API you can: enable digital payment on a Shell fuel card, access site locator API and retrieve locations based on users coordinates, preauthorize fuel payment (provide pump number, maximum fueling amount, input odometer reading), receive transactions confirmation, cancel transaction and release pump (before fuelling started).
B2B EV
use this API to get paginated list of all public Shell Recharge locations, get single location by ID, list of nearby locations, location that meet specific parameters ( connectorTypes, connectorMinPower, connectorMinPower, evseId, country )
