# pingInStoreReader

Query · GraphQL API

Triggers a beep on a connected Reader and returns the Reader information or an error if unable to ping the device.

## Authentication

- CLIENT
- SERVER
- OAUTH_APPLICATION

## Input

- `readerId` (`ID!`) — required

## Returns [InStoreReader](/braintree/graphql/reference/types/in-store-reader)

An in-store payment card reader.

### Returned fields

- `id` (`ID!`) — non-null: Unique identifier.
- `name` (`String`): Name given to the reader.
- `vendor` (`InStoreReaderVendor`): Vendor-specific information about the reader.
- `location` (`InStoreLocation`): The in-store location the reader is attached to.
- `status` (`ReaderStatus`): Current status of the reader.
- `pairedAt` (`Timestamp`): Date and time when the reader was paired.
- `lastSeenAt` (`Timestamp`): Date and time when the reader last established a connection.
- `offlineSince` (`Timestamp`): Date and time when the reader last disconnected.
- `softwareVersion` (`String`): The version of the payment application running on the Reader.

## Examples

### Ping in store reader

The `ID` scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `"4"`) or integer (such as `4`) input value will be accepted as an ID.

```graphql
query pingInStoreReader($readerId: ID!) {
  pingInStoreReader(readerId: $readerId) {
    __typename
    id
    name
    vendor {
      __typename
      ... on VerifoneVendor {
        __typename
        model
        osVersion
        serialNumber
      }
    }
    location {
      __typename
      id
    }
    status
    pairedAt
    lastSeenAt
    offlineSince
    softwareVersion
  }
}
```

---

[View the complete GraphQL schema on GitHub](https://raw.githubusercontent.com/braintree/graphql-api/refs/heads/master/schema.graphql)