# GetTerminalReadersReader

From **Stripe API**.

`GET /v1/terminal/readers/{reader}`

<p>Retrieves a <code>Reader</code> object.</p>

## Parameters

### `expand`

- Location: query
- Required: false
- Type: `array`

Specifies which fields in the response should be expanded.

### `reader`

- Location: path
- Required: true
- Type: `string`
- maxLength: `5000`

## Request body

- Required: false
### `application/x-www-form-urlencoded`

- Type: `object`

```json
{"additionalProperties":false,"type":"object"}
```

## Security

### `basicAuth`

- Type: `http`
- Request header: `Authorization`
- Scheme: `basic`
Send credentials in the `Authorization` request header using the `Basic` scheme.

Basic HTTP authentication. Allowed headers-- Authorization: Basic <api_key> | Authorization: Basic <base64 hash of `api_key:`>

### `bearerAuth`

- Type: `http`
- Request header: `Authorization`
- Scheme: `bearer`
- Bearer format: `auth-scheme`
Send the token in the `Authorization` request header using the `Bearer` scheme.

Bearer HTTP authentication. Allowed headers-- Authorization: Bearer <api_key>

## Responses

### `200`

Successful response.

### `application/json`

- Type: `object`

A Reader represents a physical device for accepting payment details.

Related guide: [Connecting to a Reader](https://stripe.com/docs/terminal/payments/connect-reader).

```json
{"description":"A Reader represents a physical device for accepting payment details.\n\nRelated guide: [Connecting to a Reader](https://stripe.com/docs/terminal/payments/connect-reader).","properties":{"device_sw_version":{"description":"The current software version of the reader.","maxLength":5000,"nullable":true,"type":"string"},"device_type":{"description":"Type of reader, one of `bbpos_chipper2x`, `bbpos_wisepos_e`, or `verifone_P400`.","enum":["bbpos_chipper2x","bbpos_wisepos_e","verifone_P400"],"type":"string"},"id":{"description":"Unique identifier for the object.","maxLength":5000,"type":"string"},"ip_address":{"description":"The local IP address of the reader.","maxLength":5000,"nullable":true,"type":"string"},"label":{"description":"Custom label given to the reader for easier identification.","maxLength":5000,"type":"string"},"livemode":{"description":"Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.","type":"boolean"},"location":{"anyOf":[{"maxLength":5000,"type":"string"},{"$ref":"#/components/schemas/terminal.location"}],"description":"The location identifier of the reader.","nullable":true,"x-expansionResources":{"oneOf":[{"$ref":"#/components/schemas/terminal.location"}]}},"metadata":{"additionalProperties":{"maxLength":500,"type":"string"},"description":"Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.","type":"object"},"object":{"description":"String representing the object's type. Objects of the same type share the same value.","enum":["terminal.reader"],"type":"string"},"serial_number":{"description":"Serial number of the reader.","maxLength":5000,"type":"string"},"status":{"description":"The networking status of the reader.","maxLength":5000,"nullable":true,"type":"string"}},"required":["device_type","id","label","livemode","metadata","object","serial_number"],"title":"TerminalReaderReader","type":"object","x-expandableFields":["location"],"x-resourceId":"terminal.reader"}
```

### `default`

Error response.

### `application/json`

- Type: `object`

An error response from the Stripe API

```json
{"description":"An error response from the Stripe API","properties":{"error":{"$ref":"#/components/schemas/api_errors"}},"required":["error"],"type":"object"}
```

## Request examples

### cURL

```shell
curl --request GET \
  --url https://api.stripe.com/v1/terminal/readers/{reader} \
  --header 'content-type: application/x-www-form-urlencoded' \
  --data '{}'
```