# Query for gas stations

**GET /gas-stations**

There are two ways to search for gas stations in a geo location. You can use either one, or none, but not both ways.

To search inside a specific radius around a given longitude and latitude provide the following query parameters:

* latitude
* longitude
* radius

To search inside a bounding box provide the following query parameter:

* boundingBox



## Servers
- Production server (preview release 2025-2): https://api.pace.cloud/poi/2025-2 (Production server (preview release 2025-2))


## Authentication methods
- O auth2
- Oidc


## Parameters


#### Query parameters
- **page[number]** (integer)
  page number
- **page[size]** (integer)
  items per page
- **filter[appType]** (array[string])
  Search only gas stations with fueling app available
- **filter[latitude]** (number(float))
  Latitude in degrees
- **filter[longitude]** (number(float))
  Longitude in degrees
- **filter[radius]** (number(float))
  Radius in meters
- **filter[boundingBox]** (array[number(float)])
  Bounding box representing left, bottom, right, top in degrees. The query parameters need to be passed 4 times in exactly the order left, bottom, right, top.
<table> <tr><th>#</th><th>Value</th><th>Lat/Long</th><th>Range</th></tr> <tr><td>0</td><td>left</td><td>Lat</td><td>[-180..180]</td></tr> <tr><td>1</td><td>bottom</td><td>Long</td><td>[-90..90]</td></tr> <tr><td>2</td><td>right</td><td>Lat</td><td>[-180..180]</td></tr> <tr><td>3</td><td>top</td><td>Long</td><td>[-90..90]</td></tr> </table>

- **filter[paymentMethod]** (string)
  Comma separated strings that filter stations according to supported payment methods.


## Responses
### 200: OK

#### Body Parameters: application/vnd.api+json (object)
- **data** (array[object])
  
- **included** (array[object])
  

### 400: Bad request

#### Body Parameters: application/vnd.api+json (object)
- **errors** (array[object])
  

### 401: OAuth token missing or invalid or a linked identity is missing.

Linked identity missing is a special case where you need to make sure that
the user has additionally logged in / authorized with a third-party.

This is not relevant for most use-cases.

The specific error code that identifies a missing linked identity is `missing-linked-identity`

Example:

```
  {
      "errors": [
          {
              "id": "cbgmhslmp1o9or9kh1p0",
              "title": "Missing linked identity for authorized access",
              "detail": "Linked identity is needed to access this resource, please check why the user does not have a linked identity",
              "status": "401",
              "code": "missing-linked-identity"
          }
      ]
  }
```


#### Body Parameters: application/vnd.api+json (object)
- **errors** (array[object])
  

### 406: The specified accept header is invalid

#### Body Parameters: application/vnd.api+json (object)
- **errors** (array[object])
  

### 500: Internal server error

#### Body Parameters: application/vnd.api+json (object)
- **errors** (array[object])
  


[Powered by Bump.sh](https://bump.sh)