Shipper Facilities

The facilities endpoint allows users to retrieve a list of facilities that match a given name, location, and search radius. The response includes detailed information about each facility, such as contact information, geographic coordinates, and operating hours.

Authentication

Include the following headers in your requests:

• Access-Token: The access token obtained from the "Create Access Token" endpoint.

• x-api-key: The API key provided by GenLogs. This header must be included in the request.

Endpoint

• URL: https://api.genlogs.io/facilities

• Method: GET

Query Parameters

• name (string, optional): The name of the facility to search for.

• city(string, optional): The location "city" around which to search for facilities. For example, "Boston" or "Atlanta"

• state(string, optional): The location "state" around which to search for facilities. For example, "Massachusetts" or "Georgia"

• radius (integer, optional): The radius (in miles) within which to search around the specified location.

Response

• 200 OK: Successfully retrieved the list of facilities matching the search criteria.

• 400 Bad Request: If required parameters are missing or invalid.

• 401 Unauthorized: If the Access-Token or x-api-key is missing or invalid.

• 500 Internal Server Error: If an error occurs on the server while processing the request.

Response Body

• facilities (array of Facility objects): List of facilities matching the search criteria.

  • contact_phone (nullable string): Phone number of the facility's contact person.

  • contact_url (nullable string): URL for the facility's contact page or website.

  • facility_name (string): Name of the facility.

  • formatted_address (string): Full address of the facility.

  • id (string): Unique identifier for the facility.

  • lat (number): Latitude of the facility's location.

  • lon (number): Longitude of the facility's location.

  • operating_hours (nullable string): Operating hours of the facility.

  • place_category (string): Category or type of place (e.g., warehouse, distribution center).

Request Example:

curl -X GET 'https://api.genlogs.io/facilities?name=coca+cola&city=&state=&radius=50' \
-H 'Access-Token: {access_token}' \
-H 'x-api-key: {your_api_key}' \
-i

Get facilities based on name, location, and radius

GEThttps://api.genlogs.io/facilities

Query parameters

Header parameters

Response

200

List of facilities

Body

application/json

facilities*array of Facility (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.genlogs.io/facilities?name=Example+Facility&city=New+York&state=NY', {
    method: 'GET',
    headers: {
      "accept": "application/json",
      "Access-Token": "[Token]",
      "x-api-key": "[x-api-key]"
    },
});
const data = await response.json();

Response

200

{
  "facilities": [
    {
      "contact_phone": "text",
      "contact_url": "text",
      "facility_name": "text",
      "formatted_address": "text",
      "id": "text",
      "lat": 0,
      "lon": 0,
      "operating_hours": "text",
      "place_category": "text"
    }
  ]
}