Customers

About the Customer API

The EverTransit Customer API allows you to create a new customer, list customers from a given email, and retrieve the details of a particular customer by its ID. To make your requests, you can use the endpoints and their methods listed below.

Endpoints

• Create a customer

• List customers

• Retrieve a customer

The Customer object

{
   "id": "5f886c22fe5dd800318f8092",
   "firstName": "John",
   "lastName": "Doe",
   "email": "[e-mail]",
   "phoneNumber": "[phone]",
   "createdTime": "2022-08-18T01:10:16.000Z",
}

Attributes

Name	Type	Description
firstName	string	The first name of the customer.
lastName	string	The last name of the customer.
email	string	The email of the customer.
id	string	A unique identifier for the customer.
phoneNumber	string	The phone number of the customer.
createdTime	string	The date and time the customer was created in ISO format.
hits	array	Information about the ride that matches the search criteria. For example, the ID, passengers, status, destination, service level, rider, driver, etc.
totalHits	number	The number of matching criteria from the search result.

Create a customer

Create a customer.

post

Create a customer.

Authorizations

Body

emailstring · emailrequired

The email of the customer.

Example: [e-mail]

firstNamestringrequired

The first name of the customer.

Example: John

lastNamestringrequired

The last name of the customer.

Example: Doe

phoneNumberstringrequired

The phone number of the customer.

Example: [phone]

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://endpoints.evertransit.com/v2beta/customers' \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "[e-mail]",
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumber": "[phone]"
  }'

200

400

401

200

{
  "id": "5f886c22fe5dd800318f809j",
  "email": "[e-mail]",
  "firstName": "John",
  "lastName": "Doe",
  "phoneNumber": "[phone]",
  "createdTime": "2022-08-16T22:06:24.024Z"
}

The customer was created successfully.

API playground for creating a customer

List customers

List customers.

get

Retrieves a list of customers that matches the criteria.

Authorizations

Query parameters

emailstring · emailoptional

Only customers with this email will be returned.

Example: [e-mail]

limitinteger · int32 · min: 1 · default: 20optional

The limit of items per page in the response.

Example: 10

pageinteger · int32 · min: 1 · default: 1optional

Specify the page to retrieve. You will need to use it if you want to retrieve specific pages.

Example: 1

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://endpoints.evertransit.com/v2beta/customers'

200

400

401

200

{
  "hits": [
    {
      "id": "5f886c22fe5dd800318f809j",
      "email": "[e-mail]",
      "firstName": "John",
      "lastName": "Doe",
      "phoneNumber": "[phone]",
      "createdTime": "2022-08-16T22:06:24.024Z"
    }
  ],
  "totalHits": 1
}

Results that match the criteria.

API playground for listing customers

Retrieve a customer

Retrieve a customer.

get

Retrieve a customer by its ID.

Authorizations

Path parameters

customerIdstringrequired

A unique identifier for the customer.

Example: 507f191e810c19729de860jk

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

401

404

200

{
  "id": "5f886c22fe5dd800318f809j",
  "email": "[e-mail]",
  "firstName": "John",
  "lastName": "Doe",
  "phoneNumber": "[phone]",
  "createdTime": "2022-08-16T22:06:24.024Z"
}

The customer was retrieved successfully.

API playground for retrieving a customer