Locations | GreenPlaces Integrations

GreenPlaces Integrations

Home Dashboard

Retrieve all locations

Retrieve all locations for a company

get

/locations

Query parameters

per_pageinteger

limit of records per page

Example: 10

pageinteger

page number

Example: 2

citystring

This field is used to filter by city model. (LIKE)

Example: Athens

statestring

This field is used to filter by state model. (LIKE)

Example: Georgia

countrystring

This field is used to filter by country model. (LIKE)

Example: United States

categorystring

This field is used to filter by category model. (LIKE)

Example: office

typestring

This field is used to filter by type model. (LIKE)

Example: Warehouse

sort_bystring

This parameter is used to sort the records by a specific field (city,state,country,place_id,category,has_commute,ownership,type,has_solar,created_at)

Example: type

sort_dirstring

Order type(asc or desc)

Example: asc

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'http://app.greenplaces.com/api/locations'

200

400

403

404

500

{
  "status": "Ok",
  "message": "Success",
  "data": [
    {
      "id": "996501df-0bfc-4f95-954d-3a5d5dc48469",
      "company_id": "996501df-0bfc-4f95-954d-3a5d5dc48469",
      "quantity": "100",
      "sku": "028868",
      "source": "factory",
      "provider_id": "996501df-0bfc-4f95-954d-3a5d5dc48469",
      "line1": "77120 Keara Mission",
      "line2": "77120 Keara Mission",
      "city": "Metairie",
      "state": "New Hampshire",
      "postal_code": "20426-6006",
      "country": "Mali",
      "formatted_address": "New Hampshire, USA",
      "latitude": "43.19385160000000",
      "longitude": "-71.5723952999999",
      "place_id": "123456",
      "data_status": "active",
      "retrieved_at": "2023-07-04T00:00:00.000000Z",
      "category": "office",
      "nickname": "Beverly Hills Office",
      "sqft": 11960,
      "has_commute": true,
      "geocode_response": {},
      "ownership": "Owned",
      "type": "Warehouse",
      "population": "Warehouse",
      "has_solar": true,
      "walkability": {},
      "bikeability": {},
      "rideability": {},
      "energy_grid_factor": 11960,
      "updated_at": "2023-06-12T17:30:21.000000Z",
      "created_at": "2023-06-12T17:30:21.000000Z",
      "integration_response": [
        "text"
      ]
    }
  ],
  "meta": {
    "pagination": {
      "current": "1",
      "last_page": "1",
      "per_page": "10",
      "total": "6"
    }
  }
}

Successful operation

Store a location

Store a location for a company

post

/locations

Body

quantityany

Quantity for the Location

Example: 100

skuany

SKU for the Location

Example: 35015

sourceany

Source for the Location

Example: factory

line1anyrequired

Line 1 for the Location

Example: 175 Atlantic St

line2any

Line 2 for the Location

Example: 175 Atlantic St

cityany

City for the Location

Example: Georgia

stateany

State for the Location

Example: Georgia

postal_codeany

Postal Code for the Location

Example: 77024-1503

countryany

Country for the Location

Example: United States

categoryany

Category for the Location

Example: Office

nicknameanyrequired

Nickname for the Location

Example: Office A/C

sqftany

The square foot for the Location

Example: 20

has_commuteany

Has commute for the Location

Example: true

ownershipany

Ownership for the Location

Example: Owned

typeanyrequired

Type for the Location

Example: Warehouse

populationany

Population for the Location

Example: 10

has_solarany

Has solar for the Location

Example: true

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'http://app.greenplaces.com/api/locations' \
  --header 'Content-Type: application/json' \
  --data '{
    "quantity": "100",
    "sku": "35015",
    "source": "factory",
    "line1": "175 Atlantic St",
    "line2": "175 Atlantic St",
    "city": "Georgia",
    "state": "Georgia",
    "postal_code": "77024-1503",
    "country": "United States",
    "category": "Office",
    "nickname": "Office A/C",
    "sqft": "20",
    "has_commute": "true",
    "ownership": "Owned",
    "type": "Warehouse",
    "population": "10",
    "has_solar": "true"
  }'

200

400

403

404

500

{
  "status": "Ok",
  "message": "Success",
  "data": {
    "id": "996501df-0bfc-4f95-954d-3a5d5dc48469",
    "company_id": "996501df-0bfc-4f95-954d-3a5d5dc48469",
    "quantity": "100",
    "sku": "028868",
    "source": "factory",
    "provider_id": "996501df-0bfc-4f95-954d-3a5d5dc48469",
    "line1": "77120 Keara Mission",
    "line2": "77120 Keara Mission",
    "city": "Metairie",
    "state": "New Hampshire",
    "postal_code": "20426-6006",
    "country": "Mali",
    "formatted_address": "New Hampshire, USA",
    "latitude": "43.19385160000000",
    "longitude": "-71.5723952999999",
    "place_id": "123456",
    "data_status": "active",
    "retrieved_at": "2023-07-04T00:00:00.000000Z",
    "category": "office",
    "nickname": "Beverly Hills Office",
    "sqft": 11960,
    "has_commute": true,
    "geocode_response": {},
    "ownership": "Owned",
    "type": "Warehouse",
    "population": "Warehouse",
    "has_solar": true,
    "walkability": {},
    "bikeability": {},
    "rideability": {},
    "energy_grid_factor": 11960,
    "updated_at": "2023-06-12T17:30:21.000000Z",
    "created_at": "2023-06-12T17:30:21.000000Z",
    "integration_response": [
      "text"
    ]
  },
  "meta": {}
}

Successful operation

Retrieve a location

Retrieve a location for a company

get

/locations/{id}

Path parameters

locationstringrequired

Id of the location

Example: 996501df-0bfc-4f95-954d-3a5d5dc48469

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'http://app.greenplaces.com/api/locations/{id}'

200

400

403

404

500

{
  "status": "Ok",
  "message": "Success",
  "data": {
    "id": "996501df-0bfc-4f95-954d-3a5d5dc48469",
    "company_id": "996501df-0bfc-4f95-954d-3a5d5dc48469",
    "quantity": "100",
    "sku": "028868",
    "source": "factory",
    "provider_id": "996501df-0bfc-4f95-954d-3a5d5dc48469",
    "line1": "77120 Keara Mission",
    "line2": "77120 Keara Mission",
    "city": "Metairie",
    "state": "New Hampshire",
    "postal_code": "20426-6006",
    "country": "Mali",
    "formatted_address": "New Hampshire, USA",
    "latitude": "43.19385160000000",
    "longitude": "-71.5723952999999",
    "place_id": "123456",
    "data_status": "active",
    "retrieved_at": "2023-07-04T00:00:00.000000Z",
    "category": "office",
    "nickname": "Beverly Hills Office",
    "sqft": 11960,
    "has_commute": true,
    "geocode_response": {},
    "ownership": "Owned",
    "type": "Warehouse",
    "population": "Warehouse",
    "has_solar": true,
    "walkability": {},
    "bikeability": {},
    "rideability": {},
    "energy_grid_factor": 11960,
    "updated_at": "2023-06-12T17:30:21.000000Z",
    "created_at": "2023-06-12T17:30:21.000000Z",
    "integration_response": [
      "text"
    ]
  },
  "meta": {}
}

Successful operation

Update a location

Update a location for a company

put

/locations/{id}

Path parameters

idstringrequired

Id of the location

Example: 996501df-0bfc-4f95-954d-3a5d5dc48469

Body

quantityany

Quantity for the Location

Example: 100

skuany

SKU for the Location

Example: 35015

sourceany

Source for the Location

Example: factory

line1anyrequired

Line 1 for the Location

Example: 175 Atlantic St

line2any

Line 2 for the Location

Example: 175 Atlantic St

cityany

City for the Location

Example: Georgia

stateany

State for the Location

Example: Georgia

postal_codeany

Postal Code for the Location

Example: 77024-1503

countryany

Country for the Location

Example: United States

categoryany

Category for the Location

Example: Office

nicknameanyrequired

Nickname for the Location

Example: Office A/C

sqftany

The square foot for the Location

Example: 20

has_commuteany

Has commute for the Location

Example: true

ownershipany

Ownership for the Location

Example: Owned

typeanyrequired

Type for the Location

Example: Warehouse

populationany

Population for the Location

Example: 10

has_solarany

Has solar for the Location

Example: true

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url 'http://app.greenplaces.com/api/locations/{id}' \
  --header 'Content-Type: application/json' \
  --data '{
    "quantity": "100",
    "sku": "35015",
    "source": "factory",
    "line1": "175 Atlantic St",
    "line2": "175 Atlantic St",
    "city": "Georgia",
    "state": "Georgia",
    "postal_code": "77024-1503",
    "country": "United States",
    "category": "Office",
    "nickname": "Office A/C",
    "sqft": "20",
    "has_commute": "true",
    "ownership": "Owned",
    "type": "Warehouse",
    "population": "10",
    "has_solar": "true"
  }'

200

400

403

404

500

{
  "status": "Ok",
  "message": "Success",
  "data": {
    "id": "996501df-0bfc-4f95-954d-3a5d5dc48469",
    "company_id": "996501df-0bfc-4f95-954d-3a5d5dc48469",
    "quantity": "100",
    "sku": "028868",
    "source": "factory",
    "provider_id": "996501df-0bfc-4f95-954d-3a5d5dc48469",
    "line1": "77120 Keara Mission",
    "line2": "77120 Keara Mission",
    "city": "Metairie",
    "state": "New Hampshire",
    "postal_code": "20426-6006",
    "country": "Mali",
    "formatted_address": "New Hampshire, USA",
    "latitude": "43.19385160000000",
    "longitude": "-71.5723952999999",
    "place_id": "123456",
    "data_status": "active",
    "retrieved_at": "2023-07-04T00:00:00.000000Z",
    "category": "office",
    "nickname": "Beverly Hills Office",
    "sqft": 11960,
    "has_commute": true,
    "geocode_response": {},
    "ownership": "Owned",
    "type": "Warehouse",
    "population": "Warehouse",
    "has_solar": true,
    "walkability": {},
    "bikeability": {},
    "rideability": {},
    "energy_grid_factor": 11960,
    "updated_at": "2023-06-12T17:30:21.000000Z",
    "created_at": "2023-06-12T17:30:21.000000Z",
    "integration_response": [
      "text"
    ]
  },
  "meta": {}
}

Successful operation

Delete a location

Delete a location for a company

delete

/locations/{id}

Path parameters

idstringrequired

Id of the location

Example: 996501df-0bfc-4f95-954d-3a5d5dc48469

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url 'http://app.greenplaces.com/api/locations/{id}'

200

400

403

404

500

{
  "status": "Ok",
  "message": "Success",
  "data": null,
  "meta": {}
}

Successful operation