The Driver API from Sheeva — 5 operation(s) for driver.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/sheeva:sheeva-driver-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: SheevaConnect Driver API
version: '2.0'
description: This SheevaConnect™ API Specification 2.0 is © 2024 Parkofon Inc.
contact:
name: Sheeva.AI
url: https://sheeva.ai/contact-us
x-company: Parkofon Inc. (d/b/a Sheeva.AI)
servers:
- url: https://us-apis.sheeva.ai
description: Production (USA)
- url: https://in-apis.sheeva.ai
description: Production (India)
- url: https://dev-us-apis.sheeva.ai
description: Sandbox (USA)
- url: https://dev-in-apis.sheeva.ai
description: Sandbox (India)
security:
- bearerAuth: []
tags:
- name: Driver
paths:
/v2/partner-apis/drivers:
post:
summary: Register Driver
operationId: registerDriver
tags:
- Driver
responses:
'201':
description: OK
content:
application/json:
example:
countryCode: '91'
phoneNumber: '5556789999'
firstName: John
lastName: Smith
email: jsmith@email.com
driverId: dri_partner_B8vR4R4vFsDoX3sg3W7z
salutation: Mr.
addressDetails:
address1: 1234 S 32 Birla Towers
address2: Jagat Nagar
city: New Delhi
district: Okhla
state: Delhi
postalCode: '249408'
description: 'This request allows to add a driver profile.
If successful, returns: HTTP 201 CREATED.'
parameters:
- name: x-sheeva-program-code
in: header
required: true
schema:
type: string
description: Provided by Sheeva
requestBody:
content:
application/json:
example:
countryCode: '1'
phoneNumber: '81342424242'
email: jdoe@email.com
firstName: John
lastName: Doe
birthDate: 21-05-1981
gender: Male
postalCode: '249408'
driverId: dri_partner_B8vR4R4vFsDoX3sg3W7z
salutation: Mr.
city: New Delhi
district: Okhla
state: Delhi
address1: 1234 S 32 Birla Towers
address2: Jagat Nagar
/v2/partner-apis/drivers/{driverId}:
get:
summary: Get List of Linked Vehicles to a Driver (Deprecated)
operationId: getListOfLinkedVehiclesToADriver
tags:
- Driver
responses:
'200':
description: Response
content:
application/json:
example:
phoneNumber: '8134242424'
countryCode: '1'
firstName: John
lastName: Doe
email: john.doe@gmail.com
driverId: dri_partner_B8vR4R4vFsDoX3sg3W7z
active: true
parameters:
- name: driverId
in: path
required: true
schema:
type: string
- name: x-sheeva-program-code
in: header
required: true
schema:
type: string
description: Provided by Sheeva
patch:
summary: Update Driver
operationId: updateDriver
tags:
- Driver
responses:
'200':
description: Response
content:
application/json:
example:
countryCode: '1'
phoneNumber: '5556789999'
firstName: John
lastName: Smith
email: jsmith@email.com
driverId: dri_partner_B8vR4R4vFsDoX3sg3W7z
active: true
salutation: Mr.
addressDetails:
address1: 1234 S 32 Birla Towers
address2: Jagat Nagar
city: New Delhi
district: Okhla
state: Delhi
postalCode: '249408'
referralPhoneNumber: '8290808122'
referralCode: POIQWE123
referredByMerchant: '123454321'
referredByFSM: '9908083242'
description: 'This request allows you to update details of a driver profile.
If successful, returns HTTP 200 OK.'
parameters:
- name: driverId
in: path
required: true
schema:
type: string
- name: x-sheeva-program-code
in: header
required: true
schema:
type: string
description: Provided by Sheeva
requestBody:
content:
application/json:
example:
countryCode: '1'
phoneNumber: '81342424242'
email: jdoe@gmail.com
firstName: John
lastName: Doe
active: true
salutation: Mr.
referralPhoneNumber: '8290808122'
referralCode: POIQWE123
city: New Delhi
district: Okhla
state: Delhi
address1: 1234 S 32 Birla Towers
address2: Jagat Nagar
postalCode: '249408'
referredByMerchant: '123454321'
referredByFSM: '9908083242'
/v2/partner-apis/drivers/{driverId}/details:
get:
summary: Get Driver Details
operationId: getDriverDetails
tags:
- Driver
responses:
'200':
description: OK
content:
application/json:
example:
driver:
countryCode: '1'
phoneNumber: '8134242424'
email: john.doe@gmail.com
firstName: John
lastName: Doe
driverId: dri_partner_B8vR4R4vFsDoX3sg3W7z
active: true
salutation: Mr.
referralPhoneNumber: '8290808122'
referralCode: POIQWE123
addressDetails:
address1: 1234 S 32 Birla Towers
address2: Jagat Nagar
city: New Delhi
district: Okhla
state: Delhi
postalCode: '249408'
referredByMerchant: '123454321'
referredByFSM: '9908083242'
pairedVehicles:
- vin: WBA33AG07PCM25883
licensePlate: ABI712G
make: BMW
model: 530e
year: '2023'
color: RED
fuelTypes:
- PETROL
- ELECTRIC
connectorType: J1772
active: true
registrationCertificateDueOn: 21-05-2024
pucDueOn: 15-05-2024
insuranceDueOn: 17-09-2024
vehicleServiceDueOn: 21-12-2024
activeSessions:
- serviceType: PARKING
id: AYABeImAH0a9_i6wb32thzMkTYQAHQABAAdTZXJ2aWNlABBDb2duaXRvVXNlclBvb2xzAAEAB2F3cy1rbXMATGFybjphd3M6a21zOmFwLXNvd...
- serviceType: CHARGING
id: AYABeImAH0a9_i6wb32thzMkTYQAHQABAAdTZXJ2aWNlABBDb2duaXRvVXNlclBvb2xzAAEAB2F3cy1rbXMATGFybjphd3M6a21zOmFwLdsgsgsg...
description: 'This request returns driver details, associated vehicles and any active sessions. This is a convinience request that combines the resources: driver, vehicle, and a possible array of sessions.
If successful, returns: HTTP 200 OK.'
parameters:
- name: driverId
in: path
required: true
schema:
type: string
- name: x-sheeva-program-code
in: header
required: true
schema:
type: string
description: Provided by Sheeva
/v2/partner-apis/drivers/{driverId}/link:
post:
summary: Link Driver to a Vehicle
operationId: linkDriverToAVehicle
tags:
- Driver
responses:
'201':
description: Created
description: 'This API allows drivers to be paired with one of the vehicles. Once paired, this driver would be sent all notifications for this vehicle.
If successful, returns: HTTP 201 CREATED.'
parameters:
- name: driverId
in: path
required: true
schema:
type: string
- name: x-sheeva-program-code
in: header
required: true
schema:
type: string
description: Provided by Sheeva
delete:
summary: Unlink Driver from a Vehicle
operationId: unlinkDriverFromAVehicle
tags:
- Driver
responses:
'200':
description: OK
description: 'This API allows drivers to unpair an already paired vehicle. Once unpaired, this driver would no longer be sent any notifications for this vehicle.
If successful, returns: HTTP 200 OK.'
parameters:
- name: driverId
in: path
required: true
schema:
type: string
- name: x-sheeva-program-code
in: header
required: true
schema:
type: string
description: Provided by Sheeva
/v2/partner-apis/drivers/{driverId}/drive:
post:
summary: Mark Driver as current Driver for a Vehicle
operationId: markDriverAsCurrentDriverForAVehicle
tags:
- Driver
responses:
'201':
description: Response
description: 'This request allows to mark the driver as current driver for the Vehicle
If successful, returns: HTTP 201 CREATED.'
parameters:
- name: driverId
in: path
required: true
schema:
type: string
- name: x-sheeva-program-code
in: header
required: true
schema:
type: string
description: Provided by Sheeva
delete:
summary: Remove Driver as Current driver for a vehicle
operationId: removeDriverAsCurrentDriverForAVehicle
tags:
- Driver
responses:
'200':
description: Response
description: 'This request allows to unmark the driver as current driver for the Vehicle
if successful it will return HTTP Status Code 200'
parameters:
- name: driverId
in: path
required: true
schema:
type: string
- name: x-sheeva-program-code
in: header
required: true
schema:
type: string
description: Provided by Sheeva
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: Access token obtained from GET /v2/auth (exchange client-id/client-secret), sent in the Authorization header.
clientCredentials:
type: apiKey
in: header
name: client-id
description: client-id + client-secret headers on GET /v2/auth to obtain an access token.