# Get all ready-to-use payment methods for user, combining created and valid methods

**GET /payment-methods?filter[status]=createdOrValid**

This request will return a list of supported payment methods for the current user that they can, in theory, use. That is, ones that are valid and can immediately be used including methods that could be used if the verification step is complated.</br></br>
This is as opposed to the regular `/payment-methods`, which does not categorize payment methods as valid for use.</br></br>
You should trigger this when the user is approaching on a gas station with fueling support to get a list of available payment methods.</br></br>
If the list is empty, you can ask the user to add a payment method to use PACE fueling.


## Servers
- Production server (preview release 2024-4): https://api.pace.cloud/pay/2024-4 (Production server (preview release 2024-4))


## Authentication methods
- OAuth2
- Oidc


## Parameters


### Query parameters
- **filter[status]** (string)

- **filter[purpose]** (string)
  When provided allows filtering by PACE resource name(s). Only payment methods suitable for the given purpose are returned.


## Responses
### 200
All the payment methods that could be used.

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

- **included** (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: application/vnd.api+json (object)
- **errors** (array[object])


### 404
Resource not found

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


### 406
The specified accept header is invalid

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


### 422
The request was well-formed but was unable to be followed due to semantic errors.

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


### 500
Internal server error

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



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