1.Register & Sign In
- Create a Shell Developer Account or sign in.
- Go to My Apps, click Add App, and name your project.
- Select the APIs you want to test
2.Get Your Credentials
- Go to Apps icon in , click view app and copy your API key and secret.
- Use your preferred API testing tool (e.g., Postman, Insomnia, curl).
3.Test Basic APIs
- Location APIs (EV Public Locations, B2B Mobility sites) are available immediately.
- Operations that can be tested without a Shell Account:
| Scenario | Description |
|---|---|
| Authentication | Test API key/secret with a simple request to confirm access. |
| Retrieve Locations | Use pagination to get the first or a specific page of EV locations. |
| Filter & Lookup | Filter by country/operator or retrieve data by location ID (include both positive and negative cases). |
4.Request Advanced Access
For APIs like Mobility Card Management, SmartPay, or Mobility Card Recent Transactions our API Support team needs to create and customize Mobility Customer account in our fleet management system.
Full access requires a verified customer relationship.
To request access, raise a support ticket via My Profile → Support → Raise Ticket.
5.Move to Production
- After signing the addendum, you’ll receive production credentials.
- Subscribe to notifications for updates and maintenance alerts
Error Handling
Shell APIs return standard HTTP status codes and custom error codes for clarity.
For detailed examples and best practices go to Error Handling and Best Practices.
