# 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.

* Create payment tokens for the paymentMethods of the user that are also
  supported at the gas station and pre-authorize the calculated maximum
  amount of money (background task).

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.



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


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

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