# Gather information when approaching at the forecourt


**POST /gas-stations/{gasStationId}/approaching**

This request will:
* Return a list of paymentMethods of the user which can be used at the
  gas station.

* Return up-to-date price information (price structure) at the gas
  station.

* Return a list of pumps available at the gas station together with the
  current status (free, inUse, readyToPay, outOfOrder). No pumps might
  be returned if the list of payment methods is empty.

The approaching is a necessary first api call for connected fueling. Without a valid approaching the [get pump](#operation/GetPump) and [wait for status change](#operation/WaitOnPumpStatusChange) calls may be answered with a `403 Forbidden` status code. An approaching is valid for one fueling only and can't be reused. If a long (not further disclosed time) has passed, the approaching is also invalidated. So if the client is receiving a `403 Forbidden` on the above mentioned calls, a new approaching has to be issued, this can be done transparent to the user.
Other than authorization, the most common error states encountered should be:
  * 404, if the gas station does not exist or ConnectedFueling is not available at this station
  * 502, if there was a communication failure with a third party (e.g. the gas station in question fails to respond). Retry is possible
  * 503, if ConnectedFueling is available, but the site is offline



## Servers
- Production server (stable release 2024-2): https://api.pace.cloud/fueling/2024-2 (Production server (stable release 2024-2))


## Authentication methods
- OAuth2
- Oidc


## Parameters

#### Path parameters
- **gasStationId** (string(uuid))
  Gas station ID

#### Query parameters
- **compile[openingHours]** (boolean)
  Reduces the opening hours rules. After compilation, only rules with the action open will remain in the response.


## Responses
### 201: Created

#### Body Parameters: application/vnd.api+json (object)
- **data** (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])
  

### 404: Resource not found

#### 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])
  

### 410: Resource is gone

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

### 415: The specified content type 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])
  

### 502: Error occurred while communicating with PACE services

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

### 503: Error occurred while communicating with gas station network

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


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