• Partnerships
  • Sign In
  • Sign In
  • Home

  • Dev Essentials

  • Payments

    • Payments

    • Refunds

    • Checkout

    • Terminal

    • Disputes

    • Invoices

    • Cards

    • Subscriptions

    • Bank Accounts

    • Payouts

    • Devices

    • Apple Pay

  • Commerce

  • Customers

  • Staff

  • Merchants

  • Objects & Enums

  • Webhook Events

  • Deprecated

  • SDKs

<- Square API

Square API

All versions ->

Devices

Create device codes used to connect Square Terminal with a 3rd-party point of sale system, and get details about all connected Terminals.

For more information, see the following guides:

  • Devices
  • Square Webhooks Overview
  • Endpoints

  • Webhooks

All versions ->

List devices

GET/v2/devices

List devices associated with the merchant.

Beta

List device codes

GET/v2/devices/codes

Lists all DeviceCodes associated with the merchant.

Create device code

POST/v2/devices/codes

Creates a DeviceCode that can be used to login to a Square Terminal device to enter the connected terminal mode.

Get device code

GET/v2/devices/codes/{id}

Retrieves DeviceCode with the associated ID.

Get device

GET/v2/devices/{device_id}

Retrieves Device with the associated device_id.

Beta
Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Contact support
  • Developer blog
  • Discord community
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2025 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy