> For the complete documentation index, see [llms.txt](https://6dot50.gitbook.io/6dot50-apis/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://6dot50.gitbook.io/6dot50-apis/pay-api/payments/get-payments-statuscodes.md).

# GET /payments/statusCodes

Gets a list of valid Payment status codes. Payment status codes are used to identify the state in which a Payment is in. This operation is for reference purposes only.

{% hint style="info" %}
For a detailed description of common Payment status codes and which operations are allowed for each status, please see [Payments](/6dot50-apis/pay-api/payments.md).
{% endhint %}

### Request

Ensure the bearer token is included in the Header of the GET operation:

<table><thead><tr><th width="187">Header</th><th width="144.33333333333331">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td><code>Authorization</code></td><td>Yes</td><td>Bearer token from <a href="/6dot50-apis/pay-api/authentication.md">/authentication/getToken</a></td></tr></tbody></table>

### Response

An array of status codes will be returned:

```
[
  {
    "code": "string",
    "description": "string"
  }
]
```

<table><thead><tr><th width="178.33333333333331">Field</th><th width="202">Response Type</th><th>Description</th></tr></thead><tbody><tr><td><code>code</code></td><td>string</td><td>Unique status code used for Payments</td></tr><tr><td><code>description</code></td><td>string</td><td>Friendly description of the status code.</td></tr></tbody></table>

{% code title="Example Response" %}

```
[
  {
    "code": "DRAFT",
    "description": "Payment in draft"
  },
  {
    "code": "SETTLED",
    "description": "Payment settled"
  },
  {
    "code": "CANCELLED",
    "description": "Payment cancelled"
  },
  {
    "code": "PENDING",
    "description": "Payment pending"
  }
]
```

{% endcode %}