Rides

About the Rides API

The EverTransit Rides API allows you to create and update a ride, as well as retrieve the details of an existing one. To make your requests, you can use the endpoints and their methods listed below.

Endpoints

• Create a ride

• Retrieve a ride

• Update a ride

The Ride object

{
  "id": "597d2186fff125a32fe9e315",
  "createdTime": "2022-08-18T01:06:41.800Z",
  "scheduledTime": "2022-08-18T01:10:16.000Z",
  "pickup": {
    "latitude": 42.483327,
    "longitude": -76.49093299999998,
    "address": "40 Catherwood Road, Ithaca, NY, United States"
  },
  "destination": {
    "latitude": 42.434911,
    "longitude": -76.49840599999999,
    "address": "403 South Cayuga Street, Ithaca, NY, United States"
  },
  "service": {
    "id": "578facccc5b9c32d51d87a46",
    "name": "Sedan Luxury",
    "description": "Luxury sedan cars for all types of rides.",
  },
  "rider": {
    "id": "5218481c3c8d4def7f000028",
    "firstName": "John",
    "lastName": "Doe",
    "email": "[e-mail]",
    "phoneNumber": "[phone]"
  },
  "driver": {
    "id": "5218481c3c8d4def7f000028",
    "firstName": "Michael",
     "lastName": "Jackson",
     "email": "[e-mail]",
     "phoneNumber": "[phone]"
  },
  "passengers": 1,
  "reservationNumber": "RES-QWERT0",
  "status": "completed",
  "vehicle": {
    "make": "Toyota",
    "model": "Corolla",
    "licensePlate": "808ZEL",
    "color": "Blue",
    "year": 2020
  },
  "externalId": "4251092660",
  "paymentMethod": "credit"
}

Attributes

Name	Type	Description
id	string	A unique identifier for the ride.
createdTime	string	The date and time the ride was created in ISO format.
scheduledTime	string	The date and time the ride was scheduled in ISO format.
pickup	object	Information about the pickup of the ride. For example, latitude, longitude, and address.
destination	object	Information about the destination of the ride. For example, latitude, longitude, and address.
service	object	Information about the service level of the ride. For example, name and description.
rider	object	Information about the rider of the ride. For example, first name, last name, email, and phone number.
driver	object	Information about the driver of the ride. For example, first name, last name, email, and phone number.
passengers	string	Amount of passengers on the ride.
reservationNumber	string	The reservation number to identify the ride.
status	string	The status of the ride.
vehicle	object	Information about the vehicle of the ride. For example, make, model, license plate, color, and year.
paymentMethod	enum	The payment method used to pay for the ride. It can be one of the followings: credit, cash, external, or invoice.
externalId	string	An external ID to associate the ride with an external system.

Create a ride

Try in the playground

Create a ride.

post

Create a new ride.

Authorizations

Body

pickupobjectrequired

destinationobjectrequired

passengersinteger · min: 1required

Amount of passengers on the ride.

Example: 2

externalIdstringoptional

An external ID to associate the ride with an external system.

Example: 4251092660

scheduledTimestring · date-timerequired

The date and time the ride was scheduled in ISO format.

Example: 2022-08-16T22:06:24.024Z

serviceobjectrequired

riderobjectrequired

driverobjectoptional

paymentMethodstring · enumoptional

The payment method used to pay for the ride.

Example: credit

Available options:

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://endpoints.evertransit.com/v2beta/rides' \
  --header 'Content-Type: application/json' \
  --data '{
    "pickup": {
      "latitude": 40.7812199,
      "longitude": -73.9665138,
      "address": "Central Park, New York, NY, USA"
    },
    "destination": {
      "latitude": 40.7812199,
      "longitude": -73.9665138,
      "address": "Empire State Building, New York, NY, USA"
    },
    "passengers": 2,
    "externalId": "4251092660",
    "scheduledTime": "2022-08-16T22:06:24.024Z",
    "service": {
      "id": "5f886c22fe5dd800318f809f"
    },
    "rider": {
      "id": "604fe0b82d0ccc7feaf69669"
    },
    "driver": {
      "id": "604fd3a7955756a6299018c9"
    },
    "paymentMethod": "credit"
  }'

200

400

401

200

{
  "id": "5f886c22fe5dd800318f809j",
  "scheduledTime": "2022-08-16T22:06:24.024Z",
  "createdTime": "2022-08-16T22:06:24.024Z",
  "pickup": {
    "latitude": 40.7812199,
    "longitude": -73.9665138,
    "address": "Central Park, New York, NY, USA"
  },
  "destination": {
    "latitude": 40.7812199,
    "longitude": -73.9665138,
    "address": "Empire State Building, New York, NY, USA"
  },
  "service": {
    "id": "5f886c22fe5dd800318f809f",
    "name": "Limo",
    "description": "Up to 12 passengers"
  },
  "rider": {
    "id": "604fe0b82d0ccc7feaf69669",
    "firstName": "John",
    "lastName": "Doe",
    "email": "[e-mail]",
    "phoneNumber": "[phone]"
  },
  "driver": {
    "id": "604fd3a7955756a6299018c9",
    "firstName": "John",
    "lastName": "Doe",
    "email": "[e-mail]",
    "phoneNumber": "[phone]"
  },
  "passengers": 2,
  "reservationNumber": "RES-1QW2E3",
  "status": "scheduled",
  "vehicle": {
    "make": "Toyota",
    "model": "Corolla",
    "licensePlate": "ABC-1234",
    "color": "red",
    "year": 2019
  },
  "externalId": "4251092660",
  "paymentMethod": "credit"
}

The ride was created successfully.

API playground for creating a ride

Retrieve a ride

Retrieve a ride.

get

Retrieve a ride by its ID.

Authorizations

Path parameters

rideIdstringrequired

A unique identifier for the ride.

Example: 507f191e810c19729de860ea

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://endpoints.evertransit.com/v2beta/rides/{rideId}'

200

401

404

200

{
  "id": "5f886c22fe5dd800318f809j",
  "scheduledTime": "2022-08-16T22:06:24.024Z",
  "createdTime": "2022-08-16T22:06:24.024Z",
  "pickup": {
    "latitude": 40.7812199,
    "longitude": -73.9665138,
    "address": "Central Park, New York, NY, USA"
  },
  "destination": {
    "latitude": 40.7812199,
    "longitude": -73.9665138,
    "address": "Empire State Building, New York, NY, USA"
  },
  "service": {
    "id": "5f886c22fe5dd800318f809f",
    "name": "Limo",
    "description": "Up to 12 passengers"
  },
  "rider": {
    "id": "604fe0b82d0ccc7feaf69669",
    "firstName": "John",
    "lastName": "Doe",
    "email": "[e-mail]",
    "phoneNumber": "[phone]"
  },
  "driver": {
    "id": "604fd3a7955756a6299018c9",
    "firstName": "John",
    "lastName": "Doe",
    "email": "[e-mail]",
    "phoneNumber": "[phone]"
  },
  "passengers": 2,
  "reservationNumber": "RES-1QW2E3",
  "status": "scheduled",
  "vehicle": {
    "make": "Toyota",
    "model": "Corolla",
    "licensePlate": "ABC-1234",
    "color": "red",
    "year": 2019
  },
  "externalId": "4251092660",
  "paymentMethod": "credit"
}

The ride was retrieved successfully.

API playground for retrieving a ride

Update a ride

Update a ride.

patch

Update a ride by its ID.

Authorizations

Path parameters

rideIdstringrequired

A unique identifier for the ride.

Example: 507f191e810c19729de860ea

Body

pickupobjectoptional

destinationobjectoptional

passengersinteger · min: 1optional

Amount of passengers on the ride.

Example: 2

externalIdstringoptional

An external ID to associate the ride with an external system.

Example: 4251092660

scheduledTimestring · date-timeoptional

The date and time the ride was scheduled in ISO format.

Example: 2022-08-16T22:06:24.024Z

serviceobjectoptional

riderobjectoptional

driverobjectoptional

paymentMethodstring · enumoptional

The payment method used to pay for the ride.

Example: credit

Available options:

statusstringoptional

The status of the ride.

Example: scheduled

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url 'https://endpoints.evertransit.com/v2beta/rides/{rideId}' \
  --header 'Content-Type: application/json' \
  --data '{
    "pickup": {
      "latitude": 40.7812199,
      "longitude": -73.9665138,
      "address": "Central Park, New York, NY, USA"
    },
    "destination": {
      "latitude": 40.7812199,
      "longitude": -73.9665138,
      "address": "Empire State Building, New York, NY, USA"
    },
    "passengers": 2,
    "externalId": "4251092660",
    "scheduledTime": "2022-08-16T22:06:24.024Z",
    "service": {
      "id": "5f886c22fe5dd800318f809f"
    },
    "rider": {
      "id": "604fe0b82d0ccc7feaf69669"
    },
    "driver": {
      "id": "604fd3a7955756a6299018c9"
    },
    "paymentMethod": "credit",
    "status": "scheduled"
  }'

200

400

401

404

200

{
  "id": "5f886c22fe5dd800318f809j",
  "scheduledTime": "2022-08-16T22:06:24.024Z",
  "createdTime": "2022-08-16T22:06:24.024Z",
  "pickup": {
    "latitude": 40.7812199,
    "longitude": -73.9665138,
    "address": "Central Park, New York, NY, USA"
  },
  "destination": {
    "latitude": 40.7812199,
    "longitude": -73.9665138,
    "address": "Empire State Building, New York, NY, USA"
  },
  "service": {
    "id": "5f886c22fe5dd800318f809f",
    "name": "Limo",
    "description": "Up to 12 passengers"
  },
  "rider": {
    "id": "604fe0b82d0ccc7feaf69669",
    "firstName": "John",
    "lastName": "Doe",
    "email": "[e-mail]",
    "phoneNumber": "[phone]"
  },
  "driver": {
    "id": "604fd3a7955756a6299018c9",
    "firstName": "John",
    "lastName": "Doe",
    "email": "[e-mail]",
    "phoneNumber": "[phone]"
  },
  "passengers": 2,
  "reservationNumber": "RES-1QW2E3",
  "status": "scheduled",
  "vehicle": {
    "make": "Toyota",
    "model": "Corolla",
    "licensePlate": "ABC-1234",
    "color": "red",
    "year": 2019
  },
  "externalId": "4251092660",
  "paymentMethod": "credit"
}

The ride was updated successfully.

API playground for updating a ride